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本 书 是 基于 Android Lollipop 平台 进行 移动 互联 网 应 用 开发 的 人 门 级 教程 ,通过 众多 开源 案例 项 目 ， 
全 面 系统 地 介绍 移动 互联 网 应 用 开发 的 方法 ,技巧 和 模式 。 

全 书 共 分 为 9 章 , 从 Android 应 用 设计 者 的 角度 系统 讲解 了 从 事 Android 移动 互联 网 应 用 开发 必须 要 
掌握 的 Android 平台 的 相关 技术 和 特性 ,主要 内 容 包括 数据 流 与 数据 解析 ,网 络 连接 与 管理 .Android 中 的 
Socket 编程 与 HTTP 编程 , Web 应 用 编程 .开放 接口 编程 .Google 云 服务 技术 等 ,全 面 总 结 了 Android 网 
络 编程 的 基本 原理 、 设 计 理 念 和 设计 模式 ,最 后 通过 一 个 综合 的 案例 项 目 阐述 了 Android 移动 互联 网 应 用 
开发 的 方法 和 技巧 。 

本 书 以 案例 贯穿 全 程 ,知识 结构 清晰 ,语言 简洁 ,易于 读者 学 习 和 提高 ,非常 适合 初学 Android 移动 互 
联网 应 用 开发 的 在 校 大 学 生 和 希望 系统 掌握 Android 互联 网 编程 的 开发 人 员 。 
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出 版 说 明 


我 国 高 职高 专 教育 经 过 十 几 年 的 发 展 , 已 经 转向 深度 教学 改革 阶段 。 
教育 部 于 2006 年 12 月 发 布 了 教 高 [L2006] 第 16 号 文件 (关于 全 面 提高 高 等 
职业 教育 教学 质量 的 若干 意见 》, 大力 推行 工学 结合 ,突出 实践 能 力 培养 ,全 
面 提高 高 职高 专 教学 质量 。 

清华 大 学 出 版 社 作 为 国内 大 学 出 版 社 的 领跑 者 ,为 了 进一步 推动 高 职 
高 专 计算 机 专业 教材 的 建设 工作 ,适应 高 职高 专 院 校 计算 机 类 人 才 培 养 的 
发 展 趋势 ,根据 教 高 L2006] 第 16 号 文件 的 精神 ,2007 年 秋季 开始 了 切合 新 
一 轮 教学 改革 的 教材 建设 工作 。 该 系列 教材 一 经 推出 ,就 得 到 了 很 多 高 职 
院 校 的 认可 和 选用 ,其 中 部 分 书籍 的 销售 量 超过 了 3 万 册 。 现 重新 组 织 优 
秀 作者 对 部 分 图 书 进行 改版 ,并 增加 了 一 些 新 的 图 书 品种 。 

目前 国内 高 职高 专 院 校 计算 机 网 络 与 软件 专业 的 教材 品种 繁多 ,但 符 
合 国家 计算 机 网 络 与 软件 技术 专业 领域 技能 型 紧缺 人 才 培 养 培训 方案 ,并 
符合 企业 的 实际 需要 ,能 够 自 成 体系 的 教材 还 不 多 。 

我 们 组 织 国内 对 计算 机 网 络 和 软件 人 才 培 养 模式 有 研究 并 且 有 过 一 段 
实践 经 验 的 高 职高 专 院 校 ,进行 了 较 长 时 间 的 研讨 和 调研 , 效 选 出 一 批 富 有 
工程 实践 经 验 和 教学 经 验 的 双 师 型 教师 ,合力 编写 了 这 套 适用 于 高 职高 专 
计算 机 网 络 、 软 件 专业 的 教材 。 

本 套 教材 的 编写 方法 是 以 任务 驱动 .案例 教学 为 核心 ,以 项 目 开发 为 主 
线 。 我 们 研究 分 析 了 国内 外 先进 职业 教育 的 培训 模式 、 教 学 方法 和 教材 特 
色 ,消化 吸收 优秀 的 经 验 和 成 果 。 以 培养 技术 应 用 型 人 才 为 目标 ,以 企业 
对 人 才 的 需要 为 依据 ,把 软件 工程 和 项 目 管理 的 思想 完全 融入 教材 体系 ， 
将 基本 技能 培养 和 主流 技术 相 结 合 ,课程 设置 重点 突出 、 主 辅 分 明 、 结 构 
合理 、 衔 接 紧凑 。 教 材 侧重 培养 学 生 的 实战 操作 能 力 , 学 `. 思 、 练 相 结合 ， 
旨 在 通过 项 目 实践 ,增强 学 生 的 职业 能 力 ,使 知识 从 书本 中 释放 并 转化 为 
专业 技能 。 


一 、 教 材 编写 思想 


本 套 教材 以 案例 为 中 心 ,以 技能 培养 为 目标 ,围绕 开发 项 目 所 用 到 的 知 
识 点 进行 讲解 ,对 某 些 知识 点 附 上 相关 的 例题 ,以 帮助 读者 理解 ,进而 将 知 
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考虑 到 是 以 “项 目 设计 ”为 核心 组 织 教学 ,所 以 在 每 一 学 期 配 有 相应 的 实 训 课程 及 项 目 
开发 手册 ,要 求学 生 在 教师 的 指导 下 ,能 整合 本 学 期 所 学 的 知识 内 容 , 相互 协作 ,综合 应 用 
该 学 期 的 知识 进行 项 目 开 发 .同时 ,在 教材 中 采用 了 大 量 的 案例 ,这 些 案例 紧密 地 结合 教材 
的 各 个 知识 点 ,循序 渐进 ,由 浅 入 深 , 在 整体 上 体现 了 内 容 主导 ,实例 解析 以 点 带 面 的 模式 ， 
配合 课程 后 期 以 项 目 设计 贯穿 教学 内 容 的 教学 模式 。 

软件 开发 技术 具有 种 类 繁多 、 更 新 速度 快 的 特点 。 本 套 教材 在 介绍 软件 开发 主流 技术 
的 同时 ,帮助 学 生 建 立 软 件 相关 技术 的 横向 及 纵向 的 关系 ,培养 学 生 综 合 应 用 所 学 知识 的 
能 力 。 


二 、 从 书 特色 


本 系列 教材 体现 目前 工学 结合 的 教改 思想 ,充分 结合 教改 现状 ,突出 项 目 面向 教学 和 任 
务 驱动 模式 教学 改革 成 果 , 打造 立体 化 精品 教材 。 

(1) 参照 和 吸纳 国内 外 优秀 计算 机 网 络 、 软 件 专业 教材 的 编写 思想 ,采用 本 土 化 的 实际 
项 目 或 者 任务 ,以 保证 其 有 更 强 的 实用 性 ,并 与 理论 内 容 有 很 强 的 关联 性 。 

(2) 准确 把 握 高 职高 专 软件 专业 人 才 的 培养 目标 和 特点 。 

(3) 充分 调查 研究 国内 软件 企业 ,确定 了 基于 Java 和 . NET 的 两 个 主流 技术 路 线 , 再 将 
其 组 合成 相应 的 课程 链 。 

(4) 教材 通过 一 个 个 教学 任务 或 者 教学 项 目 , 在 做 中 学 、 学 中 做 ,以 及 边 学 边 做 ,重点 突 
出 技能 培养 。 在 突出 技能 培养 的 同时 ,还 介绍 解决 思路 和 方法 ,培养 学 生 未 来 在 就 业 岗 位 上 
的 终身 学 习 能 力 。 

(5) 借鉴 或 采用 项 目 驱 动 的 教学 方法 和 考核 制度 ,突出 计算 机 网 络 、 软 件 人 才 培 训 的 先 
进 性 ,工具 性 、 实 践 性 和 应 用 性 。 

(6) 以 案例 为 中 心 ,以 能 力 培养 为 目标 ,并 以 实际 工作 的 例子 引入 概念 ,符合 学 生 的 认 
知 规律 。 语 言 简洁 明了 、 清 晰 易 懂 , 更 具 人 性 化 。 

(7) 符合 国家 计算 机 网 络 、 软 件 人 才 的 培养 目标 ; 采用 引入 知识 点 .讲述 知识 点 .强化 
知识 点 、 应 用 知识 点 、 综 合 知识 点 的 模式 ,由浅 入 深 地 展开 对 技术 内 容 的 讲述 。 

(8) 为 了 便于 教师 授课 和 学 生 学 习 , 清 华 大 学 出 版 社 正在 建设 本 套 教材 的 教学 服务 资 
源 。 清 华 大 学 出 版 社 网 站 (www. tup. com. cn) 免 费 提供 教材 的 电子 课件 、 案 例 库 等 资源 。 

高 职高 专 教育 正 处 于 新 一 轮 教学 深度 改革 时 期 ,从 专业 设置 课程 体系 建设 到 教材 建 
设 ,依然 是 新 课题 。 希 望 各 高 职高 专 院 校 在 教学 实践 中 积极 提出 意见 和 建议 ,并 及 时 反馈 给 
我 们 。 清 华 大 学 出 版 社 将 对 已 出 版 的 教材 不 断 地 修订 、 完 善 ,提高 教材 质量 ,完善 教材 服务 
体系 ,为 我 国 的 高 职高 专 教育 继续 出 版 优秀 的 高 质量 教材 。 





清华 大 学 出 版 社 
高 职高 专 计算 机 任务 驱动 模式 教材 编审 委员 会 
2014 年 3 月 


国家 “十 二 五 ?规划 明确 提出 要 加 快 发 展 新 一 代 信息 技术 ,移动 互联 网 
是 我 国 未 来 发 展 战 略 的 重点 方向 。 移 动 终端 App 开发 、 移 动 互联 网 平台 开 
发 .基于 HTML? 的 移动 Web 开发 是 移动 互联 网 行业 人 才 需 求 的 三 大 方 
向 。 作 为 移动 互联 网 应 用 开发 工程 师 , 基 于 TCP/IP 的 网 络 编程 能 力 ,终端 
轻 量 级 数据 库 开 发 能 力 、 基 于 典型 公共 云 平台 的 应 用 开发 能 力 是 其 必 备 的 
职业 技能 。 

本 书 以 Android SDK Lollipop 5. 0 为 开发 平台 ,以 Eclipse 为 集成 开发 
环境 ,结合 笔者 近年 来 在 手机 软件 研发 和 教学 中 积累 的 经 验 ,详细 介绍 
Android 平台 移动 互联 网 应 用 开发 的 相关 知识 。 

本 书 共 分 为 9 章 。 第 1 章 介绍 Java 中 1/O 数据 流 的 基本 知识 ,包括 
Android 平台 下 字 节 流 与 字符 流 的 处 理 , 以 及 对 象 序 列 化 与 编码 转换 的 技术 。 
第 2 章 介绍 XML 和 JSON 两 种 数据 格式 及 其 在 Android 中 的 解析 方法 ,介绍 
了 JSON 解析 工具 Gson 和 Json-lib 的 使 用 方法 。 第 3 章 介 绍 Android 平台 下 
网 络 连 接 与 管理 的 方法 , Wi-Fi 网 络 连接 与 管理 的 知识 ,以 及 网 络 服务 优化 的 
技术 。 第 4 章 介绍 网 络 编程 的 基本 知识 及 相关 API, 介 绍 了 Android 中 Socket 
编程 的 方法 和 步骤 ,以 及 UDP 编程 和 NIO 编程 的 知识 。 第 5 章 介绍 Android 

台中 HTTP 编程 的 方法 ,包括 基于 HttpURLConnection 和 HttpClient 访问 
网 络 的 方法 ,介绍 了 Android-Async-Http 和 Volley 连接 框架 的 使 用 技术 。 
第 6 章 介绍 使 用 WebView 构建 Web 应 用 的 方法 ,以 及 使 用 HTML5 开发 
Web App 的 方法 。 第 7 章 介 绍 Android 中 Web Service 编程 的 方法 ,并 通 
过 人 人 网 等 案例 介绍 基于 开放 平台 实现 互联 网 编程 的 技术 。 第 8 章 介绍 
Google 云 开发 技术 ,包括 Google 云 备份 技术 、 云 信息 技术 和 云 存 储 技术 等 。 
第 9 章 通过 分 析 Philm 项 目的 设计 和 实现 过 程 ,介绍 移动 互联 网 应 用 开发 
的 技术 架构 与 设计 模式 。 

本 书 紧密 结合 初学 者 的 学 习习 惯 和 认 知 规律 ,采用 了 大 量 简单 而 又 
实用 的 设计 案例 ,使 得 读者 在 阅读 时 不 会 有 障碍 ,并 可 通过 简单 的 代码 移 
植 就 能 够 生成 新 的 应 用 。 书 中 采用 的 开源 案例 项 目 把 与 Android 开发 相 
关 的 技术 及 设计 完美 结合 ,别具一格 ,弥补 了 一 些 Android 设计 人 员 知 识 
的 不 足 。 

本 书 由 李 维 勇 担任 主编 , 杜 亚 杰 、 石 建 担任 副 主 编 , 李 建 林 教授 主 审 。 
本 书 的 编写 得 到 了 南京 信息 职业 技术 学 院 、 金 审 学 院 等 院 校 的 大 力 支持 和 


pif 


移动 互联 网 应 用 开发 (基于 Android 平台 ) 
帮助 ,杭州 虹 云 网 络 科技 有 限 公 司 为 教材 案例 项 目的 策划 、 开 发 和 测试 提供 了 大 量 信息 , 清 
华 大 学 出 版 社 的 编辑 为 本 书 的 策划 和 出 版 提供 了 宝贵 的 经 验 和 支持 ,在 此 表示 衷心 感谢 。 
同时 ,本 书 在 编写 过 程 中 ,参考 了 大 量 的 相关 资料 ,吸取 了 许多 同人 的 宝贵 经 验 ,在 此 一 并 
致谢 。 

由 于 作者 水 平 所 限 , 琉 漏 难免 , 敬 请 广大 读者 提出 宝贵 意见 和 建议 。 教 材 配 套 课件 J 
题 答 案 及 源 代码 均 可 从 清华 大 学 出 版 社 网 站 下 载 。 
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第 1 章 7u de 流 


移动 互联 网 对 网 络 数据 流 的 处 理 要 关注 四 个 基本 方面 : 数据 流 的 编码 、 字 节 顺 序 数据 
格式 对 应 和 取 数 。 在 编写 网 络 程 序 时 ,必须 注意 这 些 问题 ,以 使 程序 能 正确 处 理 通信 的 
内 容 。 


1.1 Java 中 的 1/0 


Java 中 I/O 操作 主要 是 指使 用 Java 进行 输入 、 输 出 操作 。Java 所 有 的 L/O 机 制 都 是 
基于 数据 流 进行 输入 输出 的 ,这 些 数 据 流 表示 了 字符 或 者 字 节 数据 的 流动 序列 。Java 的 1/ 
O 流 提供 了 读 写 数据 的 标准 方法 。 任 何 Java 中 表示 数据 源 的 对 象 都 会 提供 以 数据 流 的 方 
式 读 写 其 数据 的 方法 。 


1.1.1 LO 流 


流 是 一 组 有 顺序 的 有 起 点 和 终点 的 字 节 集合 ,是 对 数据 传输 的 总 称 或 抽象 。 即 数据 在 
两 设备 间 的 传输 称 为 流 , 流 的 本 质 是 数据 传输 。 当 Java 程序 需要 从 数据 源 读 取 数据 时 ,会 
开启 一 个 到 数据 源 的 流 。 数 据 源 可 以 是 文件 .内 存 或 者 网 络 等 。 同 样 , 当 程序 需要 输出 数据 
到 目的 地 时 也 一 样 会 开启 一 个 流 ,数据 目的 地 也 可 以 是 文件 ,内存 或 者 网 络 等 。 流 的 创建 是 
为 了 更 方便 地 处 理 数据 的 输入 输出 。 

Java 根据 数据 传输 特性 将 流 抽象 为 各 种 类 ,以 便于 更 直观 地 进行 数据 操作 。 流 的 常见 
分 类 方式 包括 两 种 。 

(1) 根据 处 理 数据 类 型 的 不 同 ,分 为 字 节 流 和 字符 流 。 

字 节 流 也 称 为 原始 数据 ,需要 用 户 读 人 后 进行 相应 的 编码 转换 。 而 字符 流 的 实现 是 基 
于 自动 转换 的 , 读 取 数 据 时 会 把 数据 按照 JVM 的 默认 编码 自动 转换 成 字符 。 

字 节 流 由 java. io. InputStream 和 java. io. OutputStream 处 理 ,而 字符 流 由 java. io. 
Reader 和 java. io. Writer 处 理 。Reader 和 Writer 是 Java 后 来 版 本 新 增加 的 处 理 类 ,以 便 
使 数据 的 处 理 更 方便 。 

字 节 流 和 字符 流 的 区 别 如 下 。 

QD 读 写 单位 不 同 : 字 节 流 以 字 节 (8bit) 为 单位 ,字符 流 以 16 位 的 Unicode 码 表示 的 字 
符 为 基本 处 理 单位 ,根据 码 表 映射 字符 ,一 次 可 能 读 多 个 字 节 。 

@ 处 理 对 象 不 同 : 字 节 流 能 处 理 所 有 类 型 的 数据 (如 图 像 、 视 频 等 ) ,而 字符 流 只 能 处 
理 字符 类 型 的 数据 。 

因此 ,在 实际 编程 时 ,如 果 只 是 处 理 纯 文本 数据 ,就 优先 考虑 使 用 字符 流 。 除 此 之 外 都 
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使 用 字 节 流 。 

(2) 根据 数据 流向 不 同 , 分 为 输入 流 和 输出 流 。 

程序 从 输入 流 读 取 数据 源 ( 图 1-1) ,程序 向 输出 流 写 入 数据 (图 1-2)。 对 输入 流 只 能 进 
行 读 操作 ,对 输出 流 只 能 进行 写 操作 ,程序 中 需要 根据 待 传输 数据 的 不 同 特性 而 使 用 不 同 
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图 1-1 输入 流 





数据 流 


— Í 
010010101010 | 010010101010 
C—O 











图 1-2 输出 流 
1.1.2 Java I/O 模型 


Java 的 I/O 模型 设计 得 非常 优秀 , 它 使 用 装饰 者 (Decorator) 模 式 0 来 实现 对 各 种 输入 
输出 流 的 封装 。 

Java I/O 主要 包括 如 下 三 个 部 分 。 

CD 流 式 部 分 : 1/0 的 主体 部 分 。 

(2) 非 流 式 部 分 : 主要 包含 一 些 辅助 流 式 部 分 的 类 ,如 File 类 、RandomAccessFile 类 和 
FileDescriptor 等 类 , 

(3) 其 他 类 : 文件 读 取 部 分 与 安全 相关 的 类 ,如 SerializablePermission 类 ,以 及 与 本 地 操 
作 系 统 相关 的 文件 系统 的 类 ,如 FileSystem 类 、Win32FileSystem 类 和 WinNTFileSystem 类 。 

对 于 流 式 部 分 ,java. io 是 大 多 数 面向 数据 流 的 输入 /输出 类 的 主要 软件 包 ,按照 功能 可 
以 分 为 4 组 。 

。 基于 字 节 操作 的 1/0 接口 InputStream 和 OutputStream, 

。 基于 字符 操作 的 L/O 接口 : Writer 和 Reader. 

。 基于 磁盘 操作 的 IO 接口 : File, 

。 基于 网 络 操作 的 L/O 接口 Socket. 

前 两 组 主要 是 根据 传输 数据 的 数据 格式 ,后 两 组 主要 是 根据 传输 数据 的 方式 。 此 外 ， 


外 ”装饰 者 模式 是 面向 对 象 编程 领域 中 一 种 在 不 必 改 变 原 类 文件 和 使 用 继承 的 情况 下 动态 地 往 一 个 类 中 添加 新 行 
为 的 设计 模式 。 
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Java 也 对 块 传输 提供 支持 ,在 核心 库 java. nio 中 采用 的 便 是 块 IO。 流 1/O 的 好 处 是 简单 
易 用 ,缺点 是 效率 较 低 。 块 IO 效率 很 高 ,但 编程 比较 复杂 。 

在 Java 中 1/0 操作 的 一 般 流 程 如 下 (以 文件 操作 为 例 ): 

© 使 用 File 类 打开 一 个 文件 ; 

@ 通过 字 节 流 或 字符 流 的 子 类 ,指定 输出 的 位 置 ; 

@ 进行 读 / 写 操作 ; 

© 关闭 输入 /输出 流 。 

提示 : Java 中 的 1/0 操作 属于 资源 操作 ,使 用 完毕 后 一 定 要 记得 关闭 。 


1.1.3 1/O 异常 


异常 (Exception, 又 称 为 例外 ) 是 特殊 的 运行 错误 对 象 ,对 应 着 Java 语言 特定 的 运行 错 
误 处 理 机 制 。Java 的 异常 类 是 处 理 运行 时 错误 的 特殊 类 ,每 一 种 异常 类 对 应 一 种 特定 的 运 
行 错误 。 所 有 的 Java 异常 类 都 是 系统 类 库 中 Exception 类 的 子 类 。 

Java 最 常见 的 异常 之 一 就 是 java. io. IJOException ,包括 以 下 3 种 。 

(1) public class EOFException 

非 正 常 到 达 文 件 尾 或 输入 流 尾 时 抛 出 的 异常 。 

(2) public class FileNotFoundException 

当 文 件 找 不 到 时 抛 出 的 异常 。 

(3) public class InterruptedIOException 

当 1/0 操作 被 中 断 时 抛 出 的 异常 。 


1.2 F 节 流 


字 节 流 主要 是 操作 byte 类 型 数据 ,以 byte 数组 为 主 ,主要 操作 类 包括 InputStream 和 


OutputStream, 
1.2.1 InputStream 


InputStream 是 所 有 的 输入 字 节 流 的 父 类 , 它 是 一 个 抽象 类 ,必须 依靠 其 子 类 实现 各 种 
功能 。 继 承 自 InputStream 的 流 都 是 向 程序 中 输入 数据 的 , 且 数 据 单位 为 字 节 (8bit) 。 

1. 主要 方法 

InputStream 提供 的 主要 方法 包括 以 下 几 种 。 

(1) public abstract int read() throws IOException 

read() 方 法 从 输入 流 中 读 取 一 个 byte 的 数据 ,返回 0~255 的 int 值 。 如 果 因 为 已 经 到 
达 流 末尾 而 没有 可 用 的 字 节 , 则 返回 值 为 一 1。 在 输入 数据 可 用 、 检 测 到 流 末 尾 或 者 抛 出 异 
常 前 ,此 方法 一 直 阻塞 。 

(2) public int read(byte[ ] b) throws IOException 

read(byte[ ] b) JA fi A tii P BERR b. length 个 字 节 数据 ,并 将 其 存储 在 缓冲 区 数组 b 中 。 
返回 值 是 读 取 的 字 节 数 。 
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(3) public int read(byte[ ] b, int off, int len) throws IOException 

将 输入 流 中 最 多 len 个 数据 字 节 读 入 偏 移 量 为 off 的 b 数组 中 。 但 读 取 的 字 节 也 可 能 
小 于 该 值 。 以 整数 形式 返回 实际 读 取 的 字 节 数 。 

注意 : 

(D 如 果 数组 b 的 长 度 为 0, 则 不 读 取 任 何 字 节 并 返回 0; 否则 ,尝试 读 取 至 少 一 个 字 节 。 

O 如 果 因为 流 位 于 文件 末尾 而 没有 可 用 的 字 节 , 则 返回 值 为 一 1; 否则 ,至 少 读 取 一 个 
字 节 并 将 其 存储 在 b 中 。 

@ read(byte[] b) 方 法 将 读 取 的 第 一 个 字 节 存储 在 元 素 bL0] 中 ,下 一 个 存储 在 b[1] 
中 ,其 他 依次 类 推 。 读 取 的 字 节 数 最 多 等 于 b 的 长 度 。 设 上 为 实际 读 取 的 字 节 数 ; 这 些 字 
节 将 存储 在 bL0] 到 b[k 一 1] 的 元 素 中 ,不 影响 b[k]5] b[b. length 一 1] 的 元 素 。 

图 read(byte[ ] b, int off, int len) 方 法 将 读 取 的 第 一 个 字 节 存储 在 元 素 bLoff] 中 ,下 
一 个 存储 在 bLoft 十 1] 中 ,其 他 依次 类 推 。 读 取 的 字 节 数 最 多 等 于 len。 设 上 为 实际 读 取 的 
字 节 数 ; 这 些 字 节 将 存储 在 b[off]$] bLoff 十 k 一 1] 的 元 素 中 ,不 影响 bLoff 十 kj 到 bloff+ 
len 一 1] 的 元 素 。 在 任何 情况 下 ,b[0] 到 b[Loff] 的 元 素 以 及 b[off 十 len] 到 b[b. length 一 1] 的 
元 素 都 不 会 受到 影响 。 

© read(byte[] b) 和 read(byte[] b. int off, int len) 这 两 个 方法 都 是 用 来 从 流 里 读 取 
多 个 字 节 的 ,但 是 这 两 个 方法 经 常 读 取 不 到 自己 想 要 读 取 个 数 的 字 节 。 如 read(byte[] b) 
方法 往往 希望 程序 能 读 取 到 b. length 个 字 节 ,而 实际 情况 是 ,系统 往往 读 取 不 了 这 么 多 。 
事实 上 ,这 个 方法 并 不 能 保证 读 取 这 么 多 个 字 节 , 它 只 能 最 多 读 取 这 么 多 个 字 节 (最 少 
1 个 )。 因 此 ,如 果 要 让 程序 读 取 count 个 字 节 (除非 中 途 遇 到 I/O 异常 或 者 到 了 数据 流 的 
结尾 ), 使 用 以 下 代码 : 


01 byte[] b = new byte[count]; 

02 int readCount = 0; 

03 while (readCount < count) { 

04 readCount += in. read(bytes, readCount, count — readCount) ; 
05D) 


(4) public int available() throws IOException 

返回 输入 流 中 可 以 读 取 的 字 节 数 ,这 个 方法 必须 由 继承 InputStream 类 的 子 类 对 象 调 
用 才 有 用 。 在 一 次 读 取 多 个 字 节 时 ,经 常 调用 available() 方 法 ,这 个 方法 可 以 在 读 写 操作 前 
先 得 知 数据 流 里 有 多 少 个 字 节 可 以 读 取 。 如 果 这 个 方法 用 在 从 本 地 文件 读 取 数 据 时 ,一 般 
不 会 遇 到 问题 。 但 如 果 是 用 于 网 络 操作 ,可 能 会 遇 到 输入 阻塞 ,当前 线程 将 被 挂 起 。 如 果 
InputStream 对 象 调用 这 个 方法 , 它 只 会 返回 0。 

为 了 保证 调用 available() 方 法 从 网 络 获取 count 个 数据 ,使 用 以 下 代码 : 

01 intcount = 0; 


02 while (count == 0) { 
03 count = in.available(); 





04 
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05 byte[] b = new byte[count]; 


06 


in. read(b); 


(5) public long skip(long n) throws IOException 

跳 过 和 丢弃 此 输入 流 中 数据 的 n 个 字 节 。 出 于 各 种 原因 ,skipO 〇 方法 结束 时 跳 过 的 字 
节 数 可 能 小 于 该 数 ,也 可 能 为 0。 导 致 这 种 情况 的 原因 很 多 , 跳 过 nn 个 字 节 之 前 已 到 达 文 件 
末尾 只 是 其 中 一 种 可 能 。 返 回 跳 过 的 实际 字 节 数 。 如 果 为 负 值 , 则 不 跳 过 任何 字 节 。 

(6) public void close() throws IOException 

关闭 流 并 释放 内 存 资源 。 

在 Android 中 ,存放 在 Assets 目录 (存放 路 径 是 project/assets/file. name) 中 的 文件 会 
被 原封 不 动 地 拷贝 到 APK 中 ,而 不 会 像 其 他 资源 文件 那样 被 编译 成 二 进 制 的 形式 。 下 面 
的 代码 演示 了 使 用 InputStream 读 取 Assets 中 文件 的 方法 。 


01 public class InputStreamActivity extends Activity { 


02 private String fileName = "InputStreamExample. txt"; 
03 

04 private TextView mTextView; 

05 

06 @Override 

07 protected void onCreate( Bundle savedInstanceState) { 
08 super. onCreate(savedInstanceState) ; 

09 setContentView(R.layout.activity input stream); 
10 

hi mTextView = (TextView) findViewById(R. id. tv); 
12 mTextView. setText(getFromAsset(fileName)); 

13 } 

14 

15 private String getFromAsset(String fileName) { 

16 String res = ""; 

17 try { 

18 InputStream in = getResources().getAssets(). open( fileName); 
19 int length = in.available(); 

20 byte[] buffer = new byte[ length]; 

21 in. read( buffer) ; 

22 res = EncodingUtils. getString(buffer, "GB2312"); 
23 } catch (Exception e) { 

24 e. printStackTrace( ) ; 

25 } 

26 return res; 

27 j 

28 

29) 

2. 主要 子 类 


ByteArrayInputStream StringBufferInputStream, FileInputStream 是 三 种 基本 的 介质 
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流 , 它 们 分 别 从 Byte 数 组 StringBuffer 和 本 地 文件 中 读 取 数据 。 
其 他 的 输入 流 处 理 类 都 是 装饰 类 (Decorator 模式 ) ,包括 以 下 几 类 。 
。 BufferedInputStream, 提供 缓冲 功能 。 
* DatalnputStream: 允许 应 用 程序 以 与 机 器 无 关 方 式 从 底层 输入 流 中 读 取 基本 Java 
数据 类 型 。 应 用 程序 可 以 使 用 数据 输出 流 写 入 稍 后 由 数据 输入 流 读 取 的 数据 。 
。 PipedInputStream: 允许 从 与 其 他 线程 共用 的 管道 中 读 取 数 据 。 当 连接 到 一 个 
PipedOutputStream 后 , 它 会 读 取 后 者 输出 到 管道 的 数据 。 
* PushbackInputStream: 允许 放 回 已 经 读 取 的 数据 。 
。 SequenceInputStream; 能 对 多 个 InputStream 进行 顺序 处 理 。 
。 ObjectInputStream 和 所 有 FilterInputStream 的 子 类 : 都 是 装饰 流 ( 装 饰 器 模式 的 
主角 ) 。 
InputStream 的 继承 关系 如 图 1-3 所 示 。 


FilelnputStream 


LineNumberlInputStream 


DdtdInputStream 


PipedInputStream 


FilterInputStream 
BufferedInputStream 


PushbackInputStream 





InputStream ByteArrayInputStream 





SequencelnputStream 


StringBufferlnputStream 





TIT 


ObjectInputStream 
1-3 InputStream 的 继承 关系 
下 面 的 代码 演示 了 使 用 FileInputStream 和 FileOutputStream 读 写 SD 卡 文件 的 方法 。 


01 public class FileIOActivity extends Activity { 


02 

03 private String filePath; 

04 private String fileName = "fileio.txt"; 

05 

06 private TextView mTextView; 

07 

08 @Override 

09 protected void onCreate(Bundle savedInstanceState) { 
10 super. onCreate(savedInstanceState); 

ii setContentView(R. layout.activity file io); 

12 

13 mTextView = (TextView) findViewById(R. id. tv); 
14 

15 // 监 听 SD 卡 是 否 被 加 载 

16 if (!Environment. getExternalStorageState().equals( 
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40 
41 
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android. os. Environment. MEDIA_MOUNTED)) { 
Toast. makeText(getApplicationContext(), "请 插入 SDF", 
Toast. LENGTH_SHORT) . show(); 
finish(); // 如 果 没 有 加 载 sd 卡 , 则 退出 应 用 


} else { 
// 获 取 SD 卡 根 路 径 
filePath = Environment. getExternalStorageDirectory() 


.getAbsolutePath(); 


String info =“ 白 日 依 山 尽 ,\n 黄河 人 海流 。\n 欲 穷 千 里 目 , \n 更 上 一 层 楼 。 ; 


try { 
writeSDFile(fileName, info); 
} catch (IOException e) { 
e. printStackTrace( ) ; 
mTextView. setText(" 文 件 写 人 失败 "); 


return; 


try{ 
mTextView, setText( readSDFile( fileName)); 
} catch (IOException e) { 
e.printStackTrace(); 
nTextView. setText(" 3c Fe BU A MK") ; 


// 读 文件 
public String readSDFile(String fileName) throws IOException { 
Stringres - ""; 


File file = new File(filePath, fileName); 
FileInputStream fis = new FileInputStream(file) ; 
int length = fis. available(); 

byte[ ] buffer = new byte[ length]; 

fis. read(buffer) ; 

res = EncodingUtils. getString( buffer, "UTF - 8"); 
fis. close(); 


return res; 


// 写 文件 
public void writeSDFile(String fileName，String write_str) 
throws IOException { 
File file = new File(filePath, fileName) ; 
FileOutputStream fos = new FileOutputStream(file); 
byte[] bytes = write str.getBytes(); 
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66 fos. write(bytes) ; 
67 fos. close(); 

68 } 

69 

70 } 


注意 : 需要 在 AndroidManifest. xml 文件 中 加 入 如 下 权限 : 


«uses - permission android: name = "android. permission. WRITE EXTERNAL STORAGE" /> 


1.2.2 OutputStream 


OutputStream 是 所 有 输出 字 节 流 的 父 类 , 它 是 一 个 抽象 类 。 

1. 主要 方法 

OutputStream 提供 的 重要 方法 包括 以 下 几 种 。 

(1) public abstract void write(int b) throws IOException 

先 将 int 类 型 的 b 转换 为 byte 类 型 ,然后 写 和 信 b 的 8 个 低位 ,b 的 24 个 高 位 将 被 忽略 。 

(2) public void write(byte[ ] b) throws IOException 

将 b. length 个 字 节 从 指定 的 byte 数组 写 和 人 此 输出 流 。write(b) 方 法 应 该 与 调用 write 
(b，0，b.length) 的 效果 完全 相同 。 

(3) public void write(byte[ ] b. int off, int len) throws IOException 

将 指定 byte 数组 中 从 偏 移 量 off 开始 的 len 个 字 节 写 入 此 输出 流 。write(b, off, len) 
的 常规 协定 是 : 将 数组 b 中 的 某 些 字 节 按 顺序 写 和 输出 流 ; 元 素 bLof 据 是 此 操作 写 人 的 第 
一 个 字 节 ,bLoff 十 len 一 1] 是 此 操作 写 人 的 最 后 一 个 字 节 。 

说 明 : 

CD Je AK b 75 null, Ap E NullPointerException, 

© 如 果 参 数 off AHR. KR len 为 负 , 或 者 off 十 len 大 于 数组 b H KH, N 36:8 IndexOut- 
OfBoundsException, 

(4) public void flush() throws IOException 

刷新 此 输出 流 并 强制 写 出 所 有 缓冲 的 输出 字 节 。flush 的 常规 协定 是 : 如 果 此 输出 流 
的 实现 已 经 缓冲 了 以 前 写 和 人 的 任何 字 节 , 则 调用 此 方法 指示 应 将 这 些 字 节 立即 写 入 它们 预 
期 的 目标 。 

说 明 : 如 果 此 流 的 预期 目标 是 由 基础 操作 系统 提供 的 一 个 抽象 (如 一 个 文件 ), 则 刷新 
此 流 只 能 保证 将 以 前 写 入 流 的 字 节 传递 给 操作 系统 进行 写 入 ,但 不 保证 能 将 这 些 字 节 实际 
写 入 物理 设备 (如 磁盘 驱动 器 ) 。 

OutputStream 的 flush() 方 法 不 执行 任何 操作 。 

(5) publicvoid close) throws IOException 

关闭 流 并 释放 内 存 资源 。 关 闭 的 流 不 能 执行 输出 操作 ,也 不 能 重新 打开 。 

2. 主要 子 类 

ByteArrayOutputStream,FileOutputStream 是 两 种 基本 的 介质 流 , 前 者 实现 了 一 个 输 
出 流 ,其 中 的 数据 被 写 人 一 个 byte 数组 ; 后 者 实现 了 把 数据 流 写 人 文件 的 功能 。 缓 冲 区 会 
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随 着 数据 的 不 断 写 人 而 自动 增长 。 可 使 用 toByteArray O fl toString() 获 取 数 据 。 

其 他 的 输出 流 处 理 类 都 是 装饰 类 (Decorator 模式 ) ,包括 以 下 几 种 。 

。 BufferedOutputStream: 提供 缓冲 功能 的 输出 流 ,在 写 出 完成 之 前 要 调用 flush OR 
保证 数据 的 输出 。 

。 DataOutputStream: 数据 输出 流 允 许 应 用 程序 以 适当 方式 将 基本 Java 数据 类 型 写 
人 输出 流 中 。 然 后 ,应 用 程序 可 以 使 用 数据 输入 流 将 数据 读 入 。 

。 PipedOutputStream: 允许 以 管道 的 方式 来 处 理 流 。 可 以 将 管道 输出 流连 接 到 管道 
输入 流 来 创建 通信 管道 。 管 道 输出 流 是 管道 的 发 送 端 。 通 常 ,数据 由 某 个 线程 写 人 
PipedOutputStream 对 象 ,并 由 其 他 线程 从 连接 的 PipedInputStream 读 取 。 

。 PrintStream: 为 其 他 输出 流 添加 了 功能 ,使 它们 能 够 方便 地 打印 各 种 数据 值 表示 形 
st, Java 经 常用 到 的 System. out 或 者 System. err 都 是 PrintStream 。 

OutputStream 的 继承 关系 如 图 1-4 所 示 。 


FileOutputStream 


|_( PipedOutputStream ) -AC DataOutputStream ) 


(OutputStream HFitterOutputStream HAC Bateredouputstream ) 
L(ByteArrayOutputStream ) LC PrintStream ) 
ObjectOutputStream 


1-4 OutputStream 的 继承 关系 


Android 可 以 直接 将 文件 保存 到 设备 的 内 部 存储 器 上 。 默 认 情 况 下 , 保存 到 内 部 存储 
器 上 的 文件 对 应 用 程序 是 私有 的 ,其 他 应 用 无 法 访问 它们 。 当 用 户 务 载 应 用 程序 时 ,这 些 文 
件 会 被 移 除 。 

私有 文件 的 存放 路 径 是 data/data/[PACKAGE_NAME]/files/file. name, 如 图 1-5 
所 示 。 


























$ Threads @ Heap @ Allocatio.. P Network... iqpr File Expl. $3 Qi Emulato. 中 Systeml.. = Bi 
msl-it€-7 
Name Size Date Time Permissions Info = 
4 © cniliwy.projectOL 2015-04-12 0939 drwxr-x--x 3 

> © cache 2015-04-12 09:32 drwxrwx--x 

4 © files 2015-04-12 1112 drwarwx--x 

B OutputStreamExample 55 2015-04-12 1112 -rw-rw---- 
B lib 2015-04-12 09:32 Irwxrwxrwx -> /deta/a.. | 





4 x F 

图 1-5 私有 文件 的 存放 路 径 
下 面 的 示例 演示 了 使 用 FileInputStream 和 FileOutputStream 读 写 私有 文件 的 方法 。 
01 public class OutputStreamActivity extends Activity { 


02 private String fileName - "OutputStreamExample" ; 
03 
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04 private TextView mTextView; 

05 

06 @Override 

07 protected void onCreate(Bundle savedInstanceState) { 

os super. onCreate(savedInstanceState) ; 

09 setContentView(R.layout.activity output stream); 
10 

11 mTextView = (TextView) findViewById(R. id.tv); 

12 

13 writeFileData(fileName, "欢迎 学 习 基 于 Android 平 台 的 移动 互联 网 编程 "); 
14 mTextView. setText( readFileData(fileName)); 

15 } 

16 

17 private void writeFileData(String fileName, String message) { 
18 try { 

19 FileOutputStream fout = openFileOutput(fileName, MODE PRIVATE); 
20 byte[] bytes = message.getBytes(); 

21 fout. write(bytes) ; 

22 fout. close(); 

23 } catch (Exception e) { 

24 e. printStackTrace( ) ; 

25 } 

26 } 

27 

28 private String readFileData(String fileName) { 

29 String res = ""; 

30 try { 

3t FileInputStream fin - openFileInput(fileName); 
32 int length - fin.available(); 

33) byte[] buffer = new byte[ length]; 

34 fin. read( buffer) ; 

35 res = EncodingUtils. getString(buffer, "UTF- 8"); 
36 fin. close(); 

37 } catch (Exception e) { 

38 e. printStackTrace( ) ; 

39 } 

40 

41 return res; 

42 } 

43 

44 } 


1.3 F P A 


字符 流 主 要 操作 类 包括 Reader 和 Writer, 
1.3.1 Reader 

Reader 是 所 有 的 输入 字符 流 的 父 类 , 它 是 一 个 抽象 类 。 
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1. 主要 方法 

Reader 提供 的 重要 方法 包括 以 下 几 种 。 

(1) public int read() throws IOException 

读 取 一 个 字符 并 以 整数 的 形式 返回 (0 一 255) 。 如 果 返 回 一 1, 则 表示 已 经 到 输入 流 的 末 

尾 。 在 字符 可 用 发 生 1/O 错误 或 者 已 到 达 流 的 末尾 前 ,此 方法 一 直 阻 塞 。 

(2) public int read(char [] cbuf) throws IOException 

读 取 一 系列 字符 并 存储 到 一 个 数组 buffer, 返 回 实际 读 取 的 字符 数 。 如 果 返 回 一 1, 则 

表示 已 经 到 输入 流 的 末尾 。 

(3) public int read(char [] cbuf, int offset, int length) throws IOException 

从 offset 位 置 开 始 , 读 取 length 个 字符 并 存储 到 一 个 数组 buffer, 返 回 实 际 读 取 的 字符 

数 , 如 果 返 回 一 1, 则 表示 已 经 到 输入 流 的 末尾 。 

(4) public long skip(long n) throws IOException 

跳 过 个 字符 不 读 , 返 回 实际 跳 过 的 字符 数 。 

(5) public void close() throws IOException 

关闭 流 并 释放 内 存 资源 。 

2. 主要 子 类 

与 数据 源 直 接 接 触 的 类 包括 以 下 几 种 。 

。 CharArrayReader: 从 内 存 中 的 字符 数组 读 人 数据 ,以 对 数据 进行 流 式 读 取 。 

+ StringReader: 从 内 存 中 的 字符 串 读 人 数据 ,以 对 数据 进行 流 式 读 取 。 

* FileReader: 从 文件 中 读 和 人 数据。 注意 这 里 读 人 数据 时 会 根据 JVM 的 默认 编码 对 
数据 进行 内 转换 ,而 不 能 指定 使 用 的 编码 。 所 以 当 文件 使 用 的 编码 不 是 JVM 默认 
编码 时 ,不 要 使 用 这 种 方式 。 要 正确 地 转 码 ,使 用 InputStreamReader。 

装饰 类 包括 以 下 几 种 。 

* BufferedReader, 提供 缓冲 功能 ,使 用 readLine() 方 法 读 取 行 。 

* LineNumberReader: 提供 读 取 行 的 控制 ,如 getLineNumber() 等 方法 。 

* InputStreamReader: 字 节 流通 向 字符 流 的 桥梁 , 它 使 用 指定 的 charset 读 取 字 节 并 
将 其 解码 为 字符 。 

Reader 的 继承 关系 如 图 1-6. 









BufferedReader H Linen umberReader ) 
InputStreamReader )- CriteReader ) 
FilterReader (PushbackReader =) 


图 1-6 Reader 的 继承 关系 




















C Reader 
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在 调试 程序 的 时 候 , 一 般 都 是 在 logcat 中 查看 日 志 信 息 , 以 便 找 出 BUG 和 调试 信息 ,但 是 
如 果 在 真正 的 计算 机 上 运行 ,就 无 法 查看 LogCat 窗口 。 下 面 的 工具 类 LogcatFileManager 使 
H BufferedReader 和 InputStreamReader 读 取 日 志 信息 并 保存 到 SD 卡 上 ,以 便 调试 程序 时 
跟踪 查看 。 


01 public class LogcatFileManager { 





02 private static LogcatFileManager INSTANCE - null; 

03 private static String PATH LOGCAT; 

04 private LogDumper mLogDumper - null; 

05 private int mPId; 

06 private SimpleDateFormat simpleDateFormatl = new SimpleDateFormat( 
07 " yyyyMSdd" ) ; 

08 private SimpleDateFormat simpleDateFormat2 - new SimpleDateFormat( 
09 "yyyy - MM- dd HH:mm:ss"); 

10 

11 public static LogcatFileManager getInstance() { 

12 if (INSTANCE == null) ( 

13 INSTANCE - new LogcatFileManager(); 

14 } 

15 return INSTANCE; 

16 } 

17 

18 private LogcatFileManager() { 

19 mPId = android. os. Process. myPid(); 

20 } 

21 

22 public void startLogcatManager(Context context) { 

23 String folderPath = null; 

24 if (Environment. getExternalStorageState( ). equals( 

25 Environment.MEDIA MOUNTED)) { 

26 folderPath = Environment.getExternalStorageDirectory() 
27 .getAbsolutePath() + File. separator + "MMF ~ Logcat"; 
28 } else { 

29 folderPath = context.getFilesDir().getAbsolutePath() 
30 + File. separator + "MMF - Logcat"; 

31 } 

32 LogcatFileManager. getInstance( ). start( folderPath) ; 

33 } 

34 

35 public void stopLogcatManager() { 

36 LogcatFileManager.getInstance().stop(); 

37 į 

38 

39 private void setFolderPath( String folderPath) { 

40 File folder = new File(folderPath); 

41 if (!folder. exists()) { 

42 folder. mkdirs(); 

43 } 

44 if (!folder. isDirectory()) { 
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45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
fnr 
72 
73 
74 
75 
76 
titi 
78 
9 
80 
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throw new IllegalArgumentException( 
"The logcat folder path is not a directory: " + folderPath); 


PATH LOGCAT = folderPath. endsWith("/") ? folderPath : folderPath + "/"; 
LogUtils.d(PATH LOGCAT); 


public void start(String saveDirectoy) { 
setFolderPath(saveDirectoy); 
if (mLogDumper null) ( 
mLogDumper = new LogDumper(String.valueOf(mPId), PATH LOGCAT); 





) 
mLogDumper. start() ; 


public void stop() { 
if (mLogDumper != null) { 
mLogDumper. stopLogs( ) ; 
mLogDumper = null; 


private class LogDumper extends Thread { 
private Process logcatProc; 
private BufferedReader mReader = null; 
private boolean mRunning = true; 
String cmds = null; 
private String mPID; 
private FileOutputStream out - null; 


public LogDumper(String pid, String dir) ( 
mPID = pid; 
try { 
out = new FileOutputStream(new File(dir, "logcat- " 
+ simpleDateFormatl.format(new Date()) + ".log"), true); 
} catch (FileNotFoundException e) { 
e. printStackTrace(); 


/ xx 
A Log level: wie Olean Wi een EOE Ss 
* Show the current mPID process level of E and W log. 
x/ 
cmds = "logcat * :e * :w | grep V"(" + mPID + ")\""; 


public void stopLogs() ( 
mRunning - false; 
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94 } 

95 

96 @Override 

97 public void run() { 

98 try { 

99 logcatProc = Runtime. getRuntime(). exec(cmds) ; 
100 mReader = new BufferedReader(new InputStreamReader( 
101 logcatProc.getInputStream()), 1024); 
102 String line = null; 

103 while (mRunning && (line = mReader.readLine()) != null) { 
104 if (!mRunning) { 

105 break; 

106 } 

107 if (line. length( ) 0) { 

108 continue; 

109 } 

110 if (out != null && line.contains(mPID)) { 
111 out. write( (simpleDateFormat2.format(new Date()) + "" 
112 + line + "\n").getBytes()); 
113 } 

114 } 

115 } catch (IOException e) { 

116 e. printStackTrace( ) ; 

117 ) finally ( 

118 if (logcatProc !- null) ( 

119 logcatProc.destroy(); 

120 logcatProc = null; 

121 } 

122 if (mReader != null) { 

123 try { 

124 mReader.close(); 

125 mReader - null; 

126 } catch (IOException e) { 

S27 e. printStackTrace(); 

128 } 

129 } 

130 if (out != null) { 

131 try { 

132 out. close() ; 

133 } catch (IOException e) { 

134 e. printStackTrace(); 

135 } 

136 out = null; 

137 } 

138 } 

139 } 

140 

141 } 

142 } 
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在 Activity 中 启动 和 停止 LogcatFileManager 的 方法 如 下 : 


01 public class ReaderActivity extends Activity { 


02 
03 
04 
05 
06 
07 
08 
09 
10 
IT 
12 
13 
14 
15 
16 
17 
18 
19 
20 
ZI 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 


private String filePath; 
private TextView mTextView; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState) ; 
setContentView(R. layout.activity reader); 


mTextView = (TextView) findViewById(R. id.tv); 


// 监 听 SD 卡 是 否 被 加 载 
if (!Environment. getExternalStorageState().equals( 
android. os. Environment. MEDIA MOUNTED)) { 
Toast.makeText(getApplicationContext(), "请 插入 SDE", 
Toast.LENGTH SHORT).show(); 
finish(); // 如 果 没 有 加 载 SD 卡 , 则 退出 应 用 


) eise ( 
// 获 取 Sp 卡 根 路 径 
filePath = Environment. getExternalStorageDirectory() 


. getAbsolutePath( ); 
LogcatFileManager.getInstance().start(filePath); 
nTextView. setText(" 正 在 将 日 志 信 息 写 入 SD 卡 "); 


@Override 

protected void onStop() { 
super. onStop( ) ; 
LogcatFileManager.getInstance().stop(); 


注意 : 需要 在 AndroidManifest. xml 文件 中 加 入 如 下 权限 : 


«uses — permission android: name = "android.permission.WRITE EXTERNAL STORAGE" /> 
«uses — permission android: name = "android.permission.READ LOGS" /> 


1.3.2 Writer 


Writer 是 所 有 的 输出 字符 流 的 父 类 , 它 是 一 个 抽象 类 。 
1. 主要 方法 
Writer 提供 的 重要 方法 包括 以 下 几 种 。 
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(1) public void write(int c) throws IOException 


向 输出 流 中 写 人 一 个 字符 数据 ,要 写 和 的 字符 包含 在 给 定 整数 值 的 16 个 低位 中 ,16 个 


高 位 被 忽略 。 


(2) public void write(char [] cbuf) throws IOException 

将 一 个 字符 类 型 数组 中 的 数据 写 人 输出 流 。 

(3) public void write(char [] cbuf, int offset, int length) throws IOException 
将 一 个 字符 类 型 数组 中 的 从 指定 位 置 (offset) 开 始 的 length 个 字符 写 人 输出 流 。 
(4) public void write(String string) throws IOException 

将 一 个 字符 串 中 的 字符 输入 输出 流 。 

(5) public void write(String string, int offset, int length) throws IOException 
将 一 个 字符 串 从 指定 位 置 (offset) 开 始 的 length 个 字符 写 入 输出 流 。 

(6) void flush() throws IOException 

将 输出 流 中 缓冲 的 数据 全 部 输出 到 目的 地 。 

(7) public void close() throws IOException 

关闭 流 并 释放 内 存 资源 。 

2. 主要 子 类 

与 数据 目的 相关 的 类 包括 以 下 几 种 。 

。 CharArrayWriter: 把 内 存 中 的 字符 数组 写 人 输出 流 , 输 出 流 的 缓冲 区 会 自动 增加 大 

小 。 输 出 流 的 数据 可 以 通过 一 些 方法 重新 获取 。 

。 String Writer: 一 个 字符 流 ,可 以 用 缓冲 区 中 的 字符 串 输 出 。 

* FileWriter: 把 数据 写 和 文件。 

装饰 类 包括 以 下 几 种 。 

。 BufferedWriter: 提供 缓冲 功能 。 

* OutputStreamWriter; 字符 流通 向 字 节 流 的 桥梁 。 可 使 用 指定 的 charset HEE A 

流 中 的 字符 编码 成 字 节 。 

。 PrintWriter: 向 文本 输出 流 打印 对 象 的 格式 化 表示 形式 。 
Writer 的 继承 关系 如 图 1-7 所 示 。 


BufferedWriter 


CharArray Writer 





I-( OuputStreamReader X FileWriter D 


C Writer JHH FilterWriter 


PipedWriter 








NA 





StringWriter 





FilterWriter 


图 1-7 Writer 的 继承 关系 
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下 面 的 服务 LogService 改进 了 LogcatFileManager 的 不 足 , 其 中 写 日 志 信 息 的 部 分 代 
码 如 下 : 


01 public class LogService extends Service { 


02 private OutputStreamWriter writer; 

03 GE 

04 private void recordLogServiceLog(String msg) { 
05 if (writer != null) ( 

06 try { 

07 Date time = new Date(); 

08 writer. write(myLogSdf.format(time) + ":" + msg); 
09 writer. write("\n"); 

10 writer. flush(); 

11 } catch (IOException e) { 

12 e. printStackTrace( ) ; 

13 Log. e(TAG, e. getMessage(), e); 
14 } 

15 } 

16 } 

17 

18 ] 


1.4 对 象 序列 化 与 编码 转换 


当 两 个 进程 在 进行 远程 通信 时 ,彼此 可 以 发 送 各 种 类 型 的 数据 。 无 论 是 何 种 类 型 的 数 
据 , 都 会 以 二 进 制 序列 的 形式 在 网 络 上 传送 。 发 送 方 需要 把 这 个 对 象 序列 化 为 字 节 序列 , 才 
能 在 网 络 上 传送 ; 接收 方 则 需要 通过 反 序 列 化 把 字 节 序列 再 恢复 为 被 处 理 的 对 象 。 在 通信 
的 同时 还 需要 关注 对 象 的 编码 方式 。 


1.4.1 对 象 序列 化 


1. 相关 API 

java. io. ObjectOutputStream 代表 对 象 输出 流 , 它 的 writeObjectCObject obj) 方 法 可 对 
参数 指定 的 obj 对 象 进 行 序列 化 ,把 得 到 的 字 节 序 列 写 到 一 个 目标 输出 流 中 。 

java. io. ObjectInputStream 代表 对 象 输入 流 , 它 的 readObject() 方 法 从 一 个 源 输入 流 
中 读 取 字 节 序 列 ,再 把 它们 反 序 列 化 为 一 个 对 象 ,并 将 其 返回 。 

java. io. Serializable 接口 对 于 要 实现 它 的 类 来 说 ,主要 用 来 通知 Java 虚拟 机 ,需要 将 一 
个 对 象 序列 化 。 

注意 : 只 有 实现 了 Serializable 和 Externalizable 接口 的 类 的 对 象 才 能 被 序列 化 。 
Externalizable 接口 继承 自 Serializable 接口 ,实现 Externalizable 接口 的 类 完全 由 自身 来 控 
制 序列 化 的 行为 ,而 仅 实现 Serializable 接口 的 类 可 以 采用 默认 的 序列 化 方式 。 

2. 序列 化 的 一 般 步 又 

对 象 序列 化 包括 如 下 步骤 : 
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(1) 创建 一 个 对 象 输出 流 , 它 可 以 包装 一 个 其 他 类 型 的 目标 输出 流 , 如 文件 输出 流 ; 
(2) 通过 对 象 输出 流 的 writeObject() 方 法 写 人 对 象 。 

对 象 反 序 列 化 的 步骤 如 下 : 

CD 创建 一 个 对 象 输入 流 , 它 可 以 包装 一 个 其 他 类 型 的 源 输 入 流 , 如 文件 输入 流 ; 

(2) 通过 对 象 输入 流 的 readObject 〇 方法 读 取 对 象 。 

iE. 

(D 序列 化 时 ,只 对 对 象 的 状态 进行 保存 ,而 不 管 对 象 的 方法 。 

© 当 一 个 父 类 实现 序列 化 , 子 类 自动 实现 序列 化 ,不 需要 显示 实现 Serializable 接口 。 
Q 当 一 个 对 象 的 实例 变量 引用 其 他 对 象 ,序列 化 该 对 象 时 ,也 把 引用 对 象 进 行 序列 化 。 
@ 出 于 安全 方面 的 原因 以 及 资源 分 配 等 方面 的 考虑 ,并 非 所 有 的 对 象 都 可 以 序列 化 。 
下 面 的 示例 演示 了 保存 序列 化 数据 到 SD 卡 并 显示 的 方法 。 


01 public class SerializableActivity extends Activity { 


02 

03 private String fileName = "SerializableExample. txt" ; 
04 private String filePath; 

05 

06 private TextView mTextView; 

07 

08 @Override 

09 protected void onCreate( Bundle savedInstanceState) { 
10 super. onCreate(savedInstanceState) ; 

11 setContentView(R. layout. activity_serializable) ; 
12 

13 filePath = Environment. getExternalStorageDirectory() 
14 . getAbsolutePath( ); 

15 

16 mTextView = (TextView) findViewById(R. id. tv); 
17 

18 saveSerializableData(); 

19 

20 try { 

21 mTextView. setText(readSerializableData() ) ; 
22 } catch (StreamCorruptedException e) { 

23 e. printStackTrace( ) ; 

24 } catch (ClassNotFoundException e) { 

25 e. printStackTrace( ) ; 

26 } catch (IOException e) { 

el e. printStackTrace( ) ; 

28 } 

29 } 

30 

31 private void saveSerializableData() { 

32 

33 ChainList < Company? list = new ChainList <Company>() ; 
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34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
s7 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
HT 
78 
79 
80 
81 
82 


Company companyl = new Company(); 
companyl.setId("00001"); 
company1. setName("10086") ; 
company]. setPwd("88881234") ; 


Company company2 = new Company(); 
company2. setId("00002"); 
company2. setName("10000") ; 
company2. setPwd("12345678"); 


list.addObject(company1). addObject (company2) ; 


Serialize2SDcard. serialize2SDcard(list, filePath + File. separator 
* fileName); 


private String readSerializableData() throws StreamCorruptedException, 


IOException, ClassNotFoundException ( 
FileInputStream fis - new FileInputStream(filePath * File.separator 
* fileName); 
ObjectInputStream ois = new ObjectInputStream(fis); 
(à SuppressWarnings("unchecked" ) 
ChainList < Company» list = (ChainList < Company?) ois. readObject() ; 
StringBuilder sb = new StringBuilder(); 


for (Company company : list) { 


sb. append(company. toString() + "\n"); 


return sb. toString() ; 


class Serialize2SDcard { 


public static void serialize2SDcard( Object target, String file) { 


FileOutputStream fos = null; 

ObjectOutputStream o = null; 

try { 
fos = new FileQutputStream( file); 
o = new ObjectOutputStream( fos) ; 
o. writeObject (target) ; 


} catch (FileNotFoundException e) { 
e. printStackTrace(); 
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83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 


System. out. println(" 没 有 找到 文件 !"); 
} catch (IOException e) { 
e. printStackTrace(); 
} finally { 
try ( 
fos. close() ; 
o. close() ; 
} catch (IOException e) { 
e. printStackTrace( ) ; 


@SuppressWarnings( "resource" ) 
public static Object getObjectFromSDcard(String file) { 


if (!new File(file).exists()) 
return null; 


FileInputStream fis - null; 
ObjectInputStream in = null; 
try { 
fis = new FileInputStream(file) ; 
in = new ObjectInputStream(fis) ; 


return in. readObject(); 


} catch (FileNotFoundException e) { 
e. printStackTrace( ) ; 
System. out. println(" 没 有 找到 文件 !"); 
} catch (StreamCorruptedException e) { 
e. printStackTrace( ); 
} catch (IOException e) { 
e. printStackTrace( ); 
} catch (ClassNotFoundException e) { 
e. printStackTrace(); 
) finally ( 


try { 
fis.close(); 
in.close(); 

} catch (IOException e) { 
e. printStackTrace( ) ; 


return null; 
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说 明 : 虚拟 机 是 否 允 许 对 象 反 序列 化 ,不 仅 取决 于 类 路 径 和 功能 代码 是 否 一 致 ,还 有 
非常 重要 的 一 点 是 两 个 类 的 序列 化 ID ZS — S A E A H private static final long 
serialVersionUID — 1L), 

3. Android 中 的 序列 化 

Android 序列 化 对 象 主要 有 两 种 方法 ,实现 Serializable 接口 或 者 实现 Parcelable 接口 。 
实现 Serializable 接口 是 Java SE 本 身 就 支持 的 ,而 Parcelable 是 Android 特有 的 功能 ,效率 
比 实现 Serializable 接口 高 ,而 且 还 可 以 用 在 IPC 中 。 实 现 Serializable 接口 非常 简单 ,声明 
一 下 就 可 以 了 ; 而 实现 Parcelable 接口 稍微 复杂 一 些 ,但 效率 更 高 ,推荐 用 这 种 方法 提高 
性 能 。 

通过 实现 Parcelable 接口 序列 化 对 象 的 基本 步骤 如 下 : 

(1) 声明 实现 接口 Parcelable。 

(2) 实现 Parcelable 的 writeToParcel() 方 法 ,将 对 象 序列 化 为 一 个 Parcel MA, 

(3) 实例 化 静态 内 部 对 象 CREATOR 实现 接口 Parcelable. Creator, 内 部 对 象 
CREATOR 的 名 称 必须 全 部 大 写 。 

(4) 完成 CREATOR 的 功能 ,实现 createFromParcel() 方 法 ,将 Parcel 对 象 反 序列 化 为 
目标 对 象 。 

下 面 的 示例 演示 了 Android 中 Activity 之 间 传 递 实现 Parcelable 接口 序列 化 信息 的 
方法 。 


01 public class TransmitComplexDataActivity extends Activity { 


02 private Button mButton; 

03 

04 @Override 

05 public void onCreate(Bundle savedInstanceState) { 

06 super. onCreate(savedInstanceState) ; 

07 setContentView(R. layout. activity_transmit_complex_data) ; 
08 

09 mButton = (Button) this. findViewById(R. id. buttonl); 
10 mButton. setOnClickListener(new OnClickListener() { 
11 

12 @Override 

13 public void onClick(View v) { 

14 startTransmitParcelableData(); 

15 } 

16 

17 n; 

18 H 

19 

20 private void startTransmitParcelableData() { 
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2 
22 
23 
24 
25 
26 
27 
28 
29 
30 
3T 
32 


Book mBook = new Book(); 

mBook. setBookName( " Android Tutor"); 

mBook. setAuthor("Liweiyong"); 

Intent mIntent = new Intent(this, ShowComplexDataActivity.class); 
Bundle mBundle - new Bundle(); 

mBundle. putParcelable("parcelableData", mBook); 

mBundle. putInt("type", 2); 

mIntent. putExtras(mBundle) ; 

startActivity(mIntent) ; 


其 中 ,Book 类 实现 了 Parcelable 接口 ,代码 如 下 : 


01 public class Book implements Parcelable { 
private String bookName; 
private String author; 


02 
03 
04 
05 
06 
07 
08 
09 
10 
ihi 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 


public String getBookName() { 


return bookName; 


public void setBookName( String bookName) { 


this. bookName = bookName; 


public String getAuthor() { 


return author; 


public void setAuthor(String author) { 


this.author = author; 


public static final Parcelable. Creator < Book > CREATOR 


h 


= new Creator < Book »() { 

public Book createFromParcel(Parcel source) ( 
Book mBook - new Book(); 
mBook. bookName = source. readString(); 
mBook.author = source. readString(); 
return mBook; 


public Book[] newArray(int size) { 
return new Book[ size]; 
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35 public int describeContents() { 
36 return 0; 
37 } 
38 
39 public void writeToParcel(Parcel parcel, int flags) { 
40 parcel. writeString(bookName) ; 
41 parcel. writeString(author) ; 
42 } 
43 } 
1.4.2 编码 转换 


现实 世界 存在 着 多 种 语言 ,表示 这 些 语言 的 符号 也 千差万别 ,而 计算 机 中 存储 信息 的 最 
小 单元 是 一 个 字 节 (8 个 bit) ,能 够 表示 的 字符 范围 是 0 一 255 个 ,这 远 远 不 能 满足 人 类 表示 
语言 符号 的 要 求 。 因 此 ,两 台 交 互 的 计算 机 之 间 经 常 需要 对 交互 信息 进行 编码 转换 ,以 适应 
人 类 的 交互 。 

1. 常见 编码 

计算 机 提供 的 常见 编码 方式 包括 以 下 几 种 。 

(1) ASCII fj 

标准 ASCI 码 用 一 个 字 节 的 低 7 位 表示 符号 ,能 够 表示 128 种 字符 。 其 中 ,0 一 31 是 控 
制 字符 (如 换行 、 回 车 等 ),32 一 126 是 打印 字符 ,可 以 通过 键盘 输入 并 且 能 够 显示 出 来 。 

(2) ISO-8859-1 

标准 ASCII 码 只 能 表示 128 个 字符 ,这 显然 是 不 够 用 的 。 于 是 ISO 组 织 在 ASCII 码 基 
础 上 又 制定 了 一 系列 标准 用 来 扩展 ASCI 编码 ,它们 是 ISO-8859-1 一 ISO-8859-15 ,其 中 
ISO-8859-1 涵盖 了 大 多 数 西 欧 语言 字符 ,应 用 也 最 广泛 。ISO-8859-1 仍然 是 单字 节 编 码 ， 
它 总 共 能 表示 256 个 字符 。 

(3) GB2312/GBK/GB18030 

GB2312 的 全 称 是 (信息 交换 用 汉字 编码 字符 集 ”基本 集 》, 它 是 双 字 节 编 码 ,总 的 编码 
范围 是 Al~F7, 其 中 AT— A9 是 符号 区 ,总 共 包 含 682 个 符号 ; BO~F7 是 汉字 区 ,包含 
6763 个 汉字 。 

GBK 的 全 称 是 (汉字 内 码 扩 展 规范 》, 它 扩展 GB2312, 加 入 了 更 多 的 汉字 , 它 的 编码 范 
围 是 8140~FEFE(4#i XX7F) ,总 共有 23940 个 码 位 , 它 能 表示 21003 个 汉字 , 它 的 编码 和 
GB2312 兼容 。 

GB18030 的 全 称 是 《信息 交换 用 汉字 编码 字符 集 》, 是 我 国 的 强制 标准 , 它 可 能 是 单字 
节 、 双 字 节 或 者 四 字 节 编码 , 它 的 编码 与 GB2312 编码 兼容 ,这 个 虽然 是 国家 标准 ,但 是 实际 
应 用 系统 中 使 用 得 并 不 广泛 。 

(4) UTF-16 

UTF-16 具体 定义 了 Unicode 字符 在 计算 机 中 的 存 取 方法 。UTF-16 用 两 个 字 节 来 表 
示 Unicode 转化 格式 ,这 个 是 定 长 的 表示 方法 ,不 论 什么 字符 都 可 以 用 两 个 字 节 表示 。 
UTF-16 表示 字符 非常 方便 ,每 两 个 字 节 表示 一 个 字符 ,这 样 就 大 大 简化 了 字符 串 的 操作 ， 
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这 也 是 Java 以 UTF-16 作为 内 存 的 字符 存储 格式 一 个 很 重要 的 原因 。 
(5) UTF-8 


UTF-16 统一 采用 两 个 字 节 表示 一 个 字符 ,虽然 在 表示 上 非常 简单 方便 ,但 是 也 有 其 缺 
点 ,有 很 多 字符 用 一 个 字 节 就 可 以 表示 ,现在 要 用 两 个 字 节 表示 ,存储 空间 加 大 了 一 倍 ,这 样 


会 增 大 网 络 传输 的 流量 ,而 且 也 没 必 要 。 而 UTF-8 采用 了 一 种 变 长 技术 ,每 个 编码 
不 同 的 字 码 长 度 。 不 同类 型 的 字符 可 以 由 1 一 6 个 字 节 组 成 。 
(6) UTF-8 有 以 下 编码 规则 : 


区 域 有 





(D 如 果 一 个 字 节 最 高 位 (第 8 位 ) 为 0, 表 示 这 是 一 个 ASCII 字符 (00~~7F)。 因 此 ,所 


有 ASCII 编码 已 经 是 UTF-8 T. 


© 如 果 一 个 字 节 以 11 开头 ,连续 的 1 的 个 数 表示 这 个 字符 的 字 节 数 ,例如 : 110X XXX X 


代表 它 是 双 字 节 UTF-8 字符 的 首 字 节 。 


@ 如 果 一 个 字 节 以 10 开始 ,表示 它 不 是 首 字 节 ,需要 向 前 查找 才能 得 到 当前 字符 的 首 


字 节 。 
2. 常见 编码 转换 
(D FileReader 转 为 BufferedReader: 


BufferedReader in= new BufferedReader(new FileReader("filename. java")); 


(2) InputStream #Ẹ Jj BufferedReader: 


BufferedReader in = new BufferedReader(new InputStreamReader(System. in) ) ; 


(3) String 转 为 DataInputStream: 


DataInputStream in = new DataInputStream(new ByteArrayInputStrean(str.getBytes())); 


(4) FileInputStream 转 为 DataInputStream: 


DataInputStream in = new DataInputStream (new BufferedInputStream ( new FileInputStream 


("filename.txt"))); 


(5) FileWriter 转 为 PrintWriter; 


PrintWriter pw- new PrintWriter(new BufferedWriter("filename. out")); 


(6) FileOutputStream f£ Jj PrintStream: 


PrintStream ps = new PrintStream (new BufferedOutputStream (new FileOutputStream ( " text. 


out"))); 
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(7) FileOutputStream #4 DataOutputStream: 


DataOutputStream dos = new Data0utputStream(new BufferedOutputStream(new FileOutputStream(" 
filename.txt"))); 


Lo = 题 


l. 编程 实现 对 应 用 中 图 片 的 缓存 处 理 。 
2. 编程 实现 将 一 个 应 用 的 登录 信息 通过 序列 化 方式 在 Activity 之 间 共 享 。 
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当 移动 客户 端 向 移动 互联 网 发 送 请 求 信息 时 ,客户 端 与 服务 端 之 间 的 数据 交互 通常 以 
XML 或 JSON 格式 响应 ,这 种 格式 为 丰富 移动 互联 网 应 用 提供 了 巨大 的 支持 。 


2.1 XML 数据 解析 


Java 平台 支持 通过 许多 不 同 的 方式 来 使 用 XML, 并 且 大 多 数 与 XML 相关 的 Java API 
在 Android 上 得 到 了 完全 支持 。 


2.1.1 XML 介绍 


XML(Extensible Markup Language, 可 扩展 标记 语言 ) 是 一 种 易于 使 用 和 易于 扩展 的 
标记 语言 ,是 SGML(The Standard Generalized Markup Language, 标 准 通 用 标记 语言 ) 的 
子 集 , 主 要 用 于 Internet 的 跨 平台 数据 传递 。 

1. XML 的 结构 

XML 文档 是 由 一 组 使 用 唯一 名 称 标识 的 实体 组 成 的 ,XML 是 一 种 树 结构 , 它 从 “ 根 
部 ”开始 ,然后 扩展 到 “枝叶 ”。XML 文档 由 内 容 和 标记 (包括 声明 、 元 素 . 注 释 、 字 符 引用 
等 ) 组 成 ,通过 以 标记 包围 内 容 的 方式 将 大 部 分 内 容 包含 在 元 素 中 。 下 面 是 一 个 简单 的 
XML 文档 示例 : 


01 <?xml version= "1.0" standalone = "yes" encoding = "ISO - 8859 - 1"?> 
02 «!-- Copyright w3school.com.cn 一 一 > 


03 «note» 

04 < to > George </to> 

05 < from > John </from> 

06 < heading > Reminder </heading > 

07 < body > Don't forget the meet ing! </body > 


08 </note> 


01 行 是 一 个 XML 处 理 指令 。 处 理 指 令 以 “二 ?” 开 始 ,以 “? 二 ”结束 。“ 二 ?” 后 的 第 一 
个 单词 是 指令 名 ,如 xml, 代 表 XML FAA. version, standalone,encoding 是 三 个 特性 ,特性 
是 由 等 号 分 开 的 名 称 一 数值 对 ,等 号 左边 是 特性 名 称 ,等 号 右边 是 特性 的 值 , 用 引号 引起 来 。 
version 一 "1.0" 说 明 这 个 文档 符合 1. 0 规范 ; standalone 说 明文 档 在 这 个 文件 里 还 是 需要 
从 外 部 导入 ,standalone 二 "yes" 说 明 所 有 的 文档 都 在 这 一 文件 里 完成 ; encoding 指 文档 字 
符 编码 。 
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02 行 是 对 XML 的 注释 说 明 。 需 要 注意 的 是 : 注释 中 不 要 出 现 % 一 一 "或 “一 ”; 注释 不 
要 放 在 标记 中 ; TERRA GERE. 

03~08 行 是 对 XML 根 元 素 的 定义 和 描述 。XML 文档 的 树 形 结构 要 求 必须 有 一 个 根 
元 素 。 根 元 素 的 起 始 标记 要 放 在 所 有 其 他 元 素 起 始 标 记 之 前 , 根 元 素 的 结束 标记 要 放 在 其 
他 所 有 元 素 的 结束 标记 之 后 。 

04,05,06,07 行 是 4 个 XML 元 素 。 元 素 的 基本 结构 由 “开始 标记 ,数据 内 容 ,结束 标 
记 ” 组 成 。 其 中 ,数据 内 容 中 的 空格 不 会 被 删除 或 合并 。 需 要 注意 的 是 : 元 素 标记 区 分 大 小 
5 , From 5j «from MTA Mid: 结束 标记 必须 有 反 斜 本 ,如 二 /from> 。 

XML 元 素 标记 命名 规则 如 下 : 

* 名 字 中 可 以 包含 字母 ,数字 及 其 他 规定 的 字符 。 

。 名 字 不 能 以 数字 或 下 划 线 开头 。 

。 名 字 不 能 用 xml 开头 。 

。 名 字 中 不 能 包含 空格 和 冒号 。 

2. XML 的 语法 

(1) 所 有 XML 元 素 都 必须 有 关闭 标签 

在 XML 中 ,省 略 关闭 标签 是 非法 的 。 所 有 元 素 都 必须 有 关闭 标签 ,如 : 





01 <p>This isa paragraph</p> 


注意 : XML 声明 没有 关闭 标签 。 这 是 因为 声明 不 属于 XML 本 身 的 组 成 部 分 。 它 不 
是 XML 元 素 , 也 不 需要 关闭 标签 。 

(2) XML 标签 对 大 小 写 敏感 

XML 元 素 使 用 XML 标签 进行 定义 。XML 标签 对 大 小 写 敏感 。 必 须 使 用 相同 的 大 小 
写 来 编写 打开 标签 和 关闭 标签 (打开 标签 和 关闭 标签 通常 被 称 为 开始 标签 和 结束 标签 ), 如 ， 


01 <Message> 这 是 错误 的 </message> 
02 <message > 这 是 正确 的 </message > 


(3) XML VM TE Wf Hh ti ES 
在 XML rh, BP 7638 Ae 6 Be TE f HAE n BH <A TORK FE HE <b> TK WIT I 
ff AE UA E<b>TRAKA GER. AA Y FUCKEN EBA SBD: 


01 <b><i>This text is bold and italic</i></b> 
(4) XML 的 属性 值 必须 加 引号 


在 XML 中 ,有 时 候 要 为 元 素 添 加 属性 。 属 性 由 一 个 键 值 对 构成 ,XML 的 属性 值 必须 
加 引号 。 下 面 的 XML 文档 是 错误 的 : 


01 «note date = 08/08/2008> 


02 < to» George «/to > 
03 < from» John </from> 
04 </note> 
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属性 是 在 使 用 元 素 时 存储 额外 信息 的 一 种 方式 。 在 同一 个 文档 中 ,可 以 根据 需要 对 每 
个 元 素 的 不 同 实例 采用 不 同 的 属性 值 。 

(5) 实体 引用 

不 能 直接 在 XML 文档 内 容 中 输入 特殊 字符 。 如 果 要 在 文本 中 使 用 符号 ,必须 使 用 它 
的 字符 代码 , 即 实体 。 可 以 将 短语 (例如 公司 名 ) 设 置 为 实体 ,然后 就 可 以 在 内 容 中 使 用 该 实 
体 。 为 了 设置 实体 ,必须 先 为 它 创建 一 个 名 称 , 然 后 将 它 输入 内 容 中 。 实 体 以 & 符号 开始 ， 
并 以 分 号 结束 ,例如 “&coname;”。 然 后 在 DOCTYPE 的 方 括号 内 部 输入 代码 ,这 个 代码 识 
别 表示 实体 的 文本 。 

在 XML 中 ,有 5 个 预定 义 的 实体 引用 ,如 表 2-1 所 示 。 


表 2-1 预定 义 实体 引用 

















实体 引用 符 号 含 x 
& lt; «x 小 于 
& gts > KF 
& amp; & 和 号 
Bapos; ! 单 引号 
& aquot; F 双 引 号 








例如 ,下 例 中 ,01 行 是 错误 的 ,02 行 是 正确 的 。 


01 <message> if salary < 1000 then </message > 
02 <message>if salary &lt; 1000 then </message > 


必须 正确 地 声明 和 表示 实体 ,以 避免 错误 和 确保 正确 显示 o 

(6) XML 的 元 素 可 以 循环 典 套 

嵌 套 即 把 某 个 元 素 放 到 其 他 元 素 的 内 部 。 这 些 新 的 元 素 称 为 子 元 素 , 包 含 它们 的 元 素 
称 为 父 元 素 。 父 级 元 素 包 含 子 级 元 素 , 子 级 元 素 又 可 以 包含 自己 的 子 级 元 素 ,例如 : 

01 <?xml version = "1.0" encoding = "ISO - 8859 - 1"?» 


02 «!-- Edited with XML Spy v2007 (http://www.altova.com) --> 
03 «breakfast menu» 


04 < food» 

05 < name> Belgian Waffles </name> 

06 < price >$ 5.95 </price> 

07 < description > two of our famous Belgian Waffles with plenty of 
08 real maple syrup </description> 

09 < calories > 650 </calories > 

10 </food> 

IDE < food» 

12 < name> Strawberry Belgian Waffles </name > 

13 <price>$ 7.95 </price> 

14 <description> light Belgian waffles covered with strawberries 
15 and whipped cream </description > 

16 < calories > 900 </calories > 
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17 </food> 

18 < food» 

19 < name > Berry - Berry Belgian Waffles </name > 

20 <price>$ 8.95 «/price» 

21 <description> light Belgian waffles covered with an assortment of 
22 fresh berries and whipped cream </description > 
23 < calories > 900 </calories > 

24 </food> 

25 € food? 

26 <name> French Toast </name > 

27 « price» $ 4.50 </price> 

28 < description» thick slices made from our homemade sourdough 
29 bread </description > 

30 < calories» 600 </calories > 

31 </food > 

32 X food? 

33 < nane > Homestyle Breakfast </name > 

34 < price» $ 6.95 </price> 

35 <description> two eggs, bacon or sausage, toast, and our 
36 ever — popular hash browns </description > 

37 <calories >950 </calories > 

38 «/ food» 


39 «/breakfast menu» 


一 个 常见 的 语法 错误 是 父 元 素 和 子 元 素 的 错误 嵌 套 。 任 何 子 元 素 都 要 完全 包含 在 其 父 
元 素 的 开始 和 结束 标记 内 部 。 每 个 同胞 元 素 必须 在 下 一 个 同胞 元 素 开 始 之 前 结束 。 

3. XML 的 验证 

构造 良好 的 XML 即 遵循 所 有 XML 规则 创建 的 XML: 正确 的 元 素 命名 、 嵌 套 、 属 性 命 
名 等 。 

验证 就 是 根据 元 素 规则 检查 文档 的 结构 ,以 及 如 何 为 每 个 父 元 素 定义 子 元 素 。 这 些 规 
则 是 在 文档 类 型 定义 (Document Type Definition ,DTD) 或 模式 (Schema) 中 定义 的 。 

(D DTD 验证 

DTD 规定 了 文档 的 逻辑 结构 。 它 可 定义 文档 的 语法 ,而 文档 的 语法 反 过 来 也 能 够 让 
XML 语法 分 析 程 序 确认 页 面 标记 使 用 的 合法 性 。DTD 定义 了 页 面 的 元 素 、 元 素 的 属性 及 
元 素 和 属性 间 的 关系 。 元 素 与 元 素 间 用 起 始 标记 和 结束 标记 来 定 界 。 对 于 空 元 素 , 用 一 个 
空 元 素 标记 来 分 隔 。 每 一 个 元 素 都 有 一 个 用 名 字 标 识 的 类 型 ,也 称 为 它 的 通用 标识 符 ,并且 
它 还 可 以 有 一 个 属性 说 明 集 。 每 个 属性 说 明 都 有 一 个 名 字 和 一 个 值 。 理 想 定义 应 该 面向 描 
述 与 应 用 程序 相关 的 数据 结构 ,而 不 是 如 何 显示 数据 。 也 就 是 说 ,应 该 把 一 个 元 素 定义 为 一 
个 标题 行 ,之 后 让 样式 表 和 脚本 定义 显示 标题 行 。 

合法 的 XML 文档 是 遵守 文档 类 型 定义 语法 规则 的 形式 良好 的 XML 文档 。DTD 分 为 
以 下 三 类 。 

。 内 部 DTD 文档 





<!DOCTYPE 根 元 素 [定义 内 容 ] > 
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。 外 部 DTD 文档 


<!DOCTYPE 根 元 素 SYSTEM "DTD 文件 路 径 "> 


。 内 外 部 DTD 文档 结合 


<!DOCTYPE 根 元 素 SYSTEM "DTD 文件 路 径 " [定义 内 容 ]> 


例如 : 


01 
02 
03 
04 
05 
06 
07 
08 


<?xml version = "1.0" encoding = "ISO - 8859 - 1"?> 
<! DOCTYPE note SYSTEM "Note. dtd"? 
«note» 


< to» George </to> 

< fron» John </from> 

< heading > Reminder </heading > 

<body> Don't forget the meet ing! </body > 


</note > 


在 上 例 中 ,DOCTYPE 声明 是 对 外 部 DTD 文件 的 引用 。DTD 的 作用 是 定义 XML x 
档 的 结构 。 它 使 用 一 系列 合法 的 元 素来 定义 文档 结构 ,例如 : 


01 <!DOCTYPE note [ 


02 
03 
04 
05 
06 
07 


]> 


<! ELEMENT note (to, from, heading, body)> 
«ELEMENT to ( #PCDATA)> 

<! ELEMENT from ( # PCDATA)> 

<! ELEMENT heading ( + PCDATA)> 

<! ELEMENT body ( # PCDATA)> 


DTD 不 具有 强制 性 。 对 于 简单 的 应 用 程序 来 说 ,开发 商 不 需 建立 自己 的 DTD, 可 以 使 
用 预先 定义 的 公共 DTD 或 不 使 用 。 即 使 某 个 文档 已 经 有 DTD, 只 要 文档 组 织 是 良好 的 , 语 
法 分 析 程 序 也 不 必 对 照 DTD 来 检验 文档 的 合法 性 。 服 务 器 可 能 已 执行 了 检查 ,所 以 检验 
的 时 间 和 带宽 将 得 以 大 幅度 节省 。 

(2) XML Schema 验证 

XML Schema 是 一 组 用 于 约 东 结构 和 清晰 表达 XML 文档 的 信息 集 规则 。XML 
Schema 是 用 一 套 预 先 规定 的 XML 元 素 和 属性 创建 的 ,这 些 元 素 和 属性 定义 了 XML 文档 
的 结构 和 内 容 模式 。XML Schema 规定 XML 文档 实例 的 结构 和 每 个 元 素 / 属 性 的 数据 类 
型 。 例 如 : 


01 <xs:element name= "note"> 


02 
03 
04 
05 
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06 <xs:element name = "fron" type = "xs: string"/> 
07 <xs:element name = "heading" type = "xs:string"/> 
08 <xs:element name = "body" type = "xs: string" /> 
09 </xs : sequence > 

10 </xs :complexType > 


11 
12 </xs:element> 


所 有 Schema 文档 使 用 schema 作为 其 根 元 素 , 用 于 构造 schema 的 元 素 和 数据 类 型 来 
E] http://www. w3. org/2001/XMLSchema 命名 空间 。 
Schema 的 特性 包括 以 下 方面 。 
* Schema 基于 XML 语法 。 
。 Schema 可 以 用 能 处 理 XML 文档 的 工具 处 理 。 
* Schema 大 大 扩充 了 数据 类 型 ,可 以 自 定义 数据 类 型 。 
* Schema 支持 元 素 的 继承 一 一 Object-Oriented。 
。 Schema 支持 属性 组 。 
XML Schema 的 作用 包括 : 
。 定义 可 出 现在 文档 中 的 元 素 。 
。 定义 可 出 现在 文档 中 的 属性 。 
定义 哪个 元 素 是 子 元 素 。 
。 定义 子 元 素 的 次 序 。 
。 定义 子 元 素 的 数目 。 
。 定义 元 素 是 否 为 空 ,或 者 是 否 可 包含 文本 。 
。 定义 元 素 和 属性 的 数据 类 型 。 
。 定义 元 素 和 属性 的 默认 值 以 及 固定 值 。 


2.1.2 Android 中 的 XML 解析 


在 Android 中 ,常见 的 XML 解析 器 分 别 为 DOM 解析 、SAX 解析 和 PULL 解析 。 

1. DOM 解析 

DOM«(Document Object Model)  W3C Ab 38 XML 的 标准 API, 允许 开发 人 员 使 用 
DOM API X Jj XML # ,检索 所 需 数据 。DOM 是 基于 树 形 结构 的 节点 或 信息 片段 的 集 
合 , 分 析 该 结构 通常 需要 加 载 整 个 文档 和 构造 树 形 结构 ,然后 才 可 以 检索 和 更 新 节点 
信息 。 

DOM 解析 的 优点 是 : 由 于 DOM 的 处 理 方式 是 将 XML 整个 作为 类 似 树 结构 的 方式 读 
入 内 存 中 ,因此 检索 和 更 新 效率 会 更 高 ,同时 支持 应 用 程序 对 XML 数据 进行 删除 \ 修 改 、 重 
新 排列 等 多 种 操作 。 但 是 由 于 其 需要 在 处 理 开始 时 将 整个 XML 文件 读 入 内 存 中 去 进行 分 
析 , 因 此 其 在 解析 大 数据 量 的 XML 文件 时 会 遇 到 类 似 于 内 存 泄 露 以 及 程序 崩溃 的 风险 。 
因此 ,DOM 解析 方式 适合 于 小 型 XML 文件 解析 、 需 要 全 解析 或 者 大 部 分 解析 XML、 需 要 
修改 XML 树 内 容 以 生成 自己 的 对 象 模 型 。 
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DOM 解析 的 基本 步骤 是 : 

(D 将 XML 文件 加 载 进来 ; 

@ 获取 文档 的 根 节点 ; 

@ 获取 文档 根 节点 中 所 有 子 节点 的 列表 ; 
@ 获取 子 节 点 列表 中 需要 读 取 的 节点 信息 。 
例如 ,有 下 面 的 XML 文档 books. xml: 


01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 
16 
17 
18 


<?xml version = "1.0" encoding = "utf - 8"?> 
< books > 
< book > 
< id» 1001 </id> 
< name > Thinking In Java </name > 
< price» 80.00 </price> 
</book > 
< book > 
< id > 1002 </id> 
< nane > Core Java </name > 
< price >90.00</price> 
</book > 
X book > 
< id > 1003 </id> 
<name> Hello, Andriod «/name > 
< price» 100.00 </price > 
</book > 
</books > 


在 Activity 的 parsingXML() 方 法 中 调用 如 下 代码 : 


01 
02 
03 
04 
05 
06 
07 
08 
09 
10 


try ( 
InputStream is = getAssets().open("books. xml"); 
parser = new DomBookParser() ; 
books = parser. parse( is); 
for (Book book : books) { 
Log. i(TAG, book. toString()); 
} 
} catch (Exception e) { 
Log.e(TAG, e.getMessage()); 


其 中 的 parse() 方 法 代码 如 下 : 


01 
02 
03 
04 
05 
06 


@Override 
public List «Book > parse( InputStream is) throws Exception { 
List <Book> books = new ArrayList < Book >(); 
DocumentBuilderFactory factory = DocumentBuilderFactory. newInstance( ) ; 
DocumentBuilder builder = factory. newDocumentBuilder() ; 
Document doc = builder. parse(is) ; 
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07 Element rootElement = doc.getDocumentElement(); 

08 NodeList items = rootElement. getElementsByTagName(" book" ) ; 

09 

10 for (int i = 0; i< items.getLength(); i++) { 

1 Book book = new Book(); 

12 Node item = items. item(i); 

Ta NodeList properties = item.getChildNodes(); 

14 

15 for (int j = 0; j < properties. getLength(); j++) ( 

16 Node property - properties. item(j); 

17 String nodeName = property. getNodeName() ; 

18 

19 if (nodeName. equals("id")) { 

20 book. setId( Integer. parseInt( property. getFirstChild() 
21 .getNodeValue())); 

22 } else if (nodeNane. equals("name")) { 

23 book. setName( property. getF irstChild( ) . getNodeValue( ) ) ; 
24 } else if (nodeName. equals("price")) { 

25 book. setPrice(Float. parseFloat( property. getFirstChild( ) 
26 . getNodeValue() ) ) ; 

27 } 

28 } 

29 

30 books. add( book) ; 

31 } 

32 

33 return books; 

34 } 


1) javax. xml. parsers 包 的 API 简介 

(1) DocumentBuilderFactory 

定义 工厂 API, 使 应 用 程序 能 够 从 XML 文档 获取 生成 DOM 对 象 树 的 解析 器 。 在 这 里 使 
用 DocumentBuilderFacotry 是 为 了 创建 与 具体 解析 器 无 关 的 程序 , 当 DocumentBuilderFactory 
类 的 静态 方法 newInstance() 被 调用 时 , 它 根 据 一 个 系统 变量 来 决定 具体 使 用 哪 一 个 解析 
器 。 又 因为 所 有 的 解析 器 都 服从 于 JAXP 所 定义 的 接口 ,所 以 无 论 具体 使 用 哪 一 个 解析 器 ， 
代码 都 是 一 样 的 。 所 以 当 在 不 同 的 解析 器 之 间 进 行 切换 时 ,只 需要 更 改 系统 变量 的 值 , 而 不 
用 更 改 任何 代码 。 这 就 是 工厂 所 带 来 的 好 处 。 

。 DocumentBuilderFactory 提供 的 重要 方法 包括 以 下 几 种 。 

* newInstanceO : 获取 DocumentBuilderFactory 的 新 实例 。 

newDocumentBuilderO ; 使 用 当前 配置 的 参数 创建 一 个 新 的 DocumentBuilder 实例 。 

(2) DocumentBuilder 

定义 API, 使 其 从 XML 文档 获取 DOM 文档 实例 。 当 获得 一 个 DocumentBuilderFactory 
工厂 对 象 后 ,使 用 它 的 静态 方法 newDocumentBuilder() 可 以 获得 一 个 DocumentBuilder 对 
象 ,这 个 对 象 代 表 了 具体 的 DOM 解析 器 。 

33 


移动 互联 网 应 用 开发 (基于 Android ¥ 8) 





DocumentBuilder 提供 的 重要 方法 包括 以 下 几 种 。 
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parse(File D : 将 给 定 文件 的 内 容 解析 为 一 个 XML 文档, 并且 返回 一 个 新 的 DOM 
Document 对 象 。 

parse(InputSource is) : 将 给 定 输入 源 的 内 容 解析 为 一 个 XML 文档 ,并 且 返 回 一 个 
新 的 DOM Document 对 象 。 

parse(InputStream is); 将 给 定 InputStream 的 内 容 解析 为 一 个 XML 文档 ,并 且 返 
回 一 个 新 的 DOM Document 对 象 。 

parse(InputStream is, String systemId) : 将 给 定 InputStream 的 内 容 解析 为 一 个 
XML 文档 ,并 且 返 回 一 个 新 的 DOM Document 对 象 。 

parse(String uri): 将 给 定 URI 的 内 容 解析 为 一 个 XML 文档 ,并 且 返 回 一 个 新 的 
DOM Document 对 象 。 

newDocument(); 获取 DOM Document 对 象 的 一 个 新 实例 来 生成 一 个 DOM 树 。 


2) org. w3c. dom 包 的 API 简介 

(1) Document 

Document 对 象 代表 了 整个 XML 的 文档 ,所 有 其 他 的 Node 都 以 一 定 的 顺序 包含 在 
Document 对 象 内 ,排列 成 一 个 树 形 的 结构 ,程序 员 可 以 通过 遍历 这 棵 树 来 得 到 XML 文档 
的 所 有 内 容 , 这 也 是 对 XML 文档 操作 的 起 点 。 

Document 接口 提供 的 重要 方法 包括 以 下 几 种 。 


createAttribute(String): 用 给 定 的 属性 名 创建 一 个 Attr 对 象 ,并 可 在 其 后 使 用 
setAttributeNode() 方 法 来 放置 在 某 一 个 Element 对 象 上 面 。 
createElement(String) : 用 给 定 的 标签 名 创建 一 个 Element 对 象 ,代表 XML 文档 中 
的 一 个 标签 ,然后 就 可 以 在 这 个 Element 对 象 上 添加 属性 或 进行 其 他 的 操作 。 
createTextNode(String) ; 用 给 定 的 字符 串 创建 一 个 Text 对 象 , Text 对 象 代表 了 标 
签 或 者 属性 中 所 包含 的 纯 文 本 字符 串 。 如 果 在 一 个 标签 内 没有 其 他 标签 ,那么 标签 
内 的 文本 所 代表 的 Text 对 象 就 是 这 个 Element 对 象 的 唯一 子 对 象 。 
getDocumentElementO ; 返回 一 个 代表 这 个 DOM 树 的 根 节 点 的 Element 对 象 ,也 
就 是 代表 XML 文档 根 元 素 的 那个 对 象 。 

getDocumentURIO : 文档 的 位 置 , 如 果 未 定义 或 Document 是 使 用 DOMImplemen- 
tation. createDocument 创建 的 , 则 为 null。 

getDomConfig(): 调用 Document. normalizeDocument() 时 使 用 的 配置 。 
getElementById(String elementId) ; 返回 具有 带 给 定 值 的 ID 属性 的 Element, 
getElementsByTagName(String tagname) : 按 文档 顺序 返回 包含 在 文档 中 且 具 有 
给 定 标记 名 称 的 所 有 Element 的 NodeList. 

getElementsByTagNameNS(String namespaceURI, String localName) : 以 文档 顺 
序 返 回 具有 给 定 本 地 名 称 和 名 称 空间 URI 的 所 有 Elements 的 NodeList。 
getImplementation() : 处 理 此 文档 的 DOMImplementation 对 象 。 
getXmlEncoding() : 作为 XML 声明 的 一 部 分 ,指定 此 文档 编码 的 属性 。 
getXmlStandaloneO : 作为 XML 声明 的 一 部 分 ,指定 此 文档 是 否 为 独立 文档 的 
属性 。 





* getXmlVersionO : 作为 XML 声明 的 一 部 分 ,指定 此 文档 版 本 号 的 属性 。 
importNode(Node importedNode, boolean deep): 从 另 一 文档 向 此 文档 导入 节点 ， 
而 不 改变 或 移 除 原始 文档 中 的 源 节点 。 此 方法 创建 源 节点 的 一 个 新 副本 。 
* normalizeDocument O : 此 方法 的 行为 如 同 使 文档 通过 一 个 保存 和 加 载 的 过 程 ,而 将 
其 置 为 normal( 标 准 ) 形 式 。 
* renameNode (Node n, String namespaceURI, String qualifiedName): 重 命名 
ELEMENT NODE x ATTRIBUTE NODE 类 型 的 现 有 节点 。 
* normalize; 可 以 去 掉 XML 文档 中 作为 格式 化 内 容 的 空白 而 映射 在 DOM 树 中 的 不 
必要 的 Text Node 对象 。 
(2) Node 
Node 对 象 是 DOM 结构 中 最 为 基本 的 对 象 ,代表 了 文档 树 中 的 一 个 抽象 的 节点 。 在 实 
际 使 用 的 时 候 , 很 少 会 真正 用 到 Node 这 个 对 象 , 而 是 用 到 诸如 Element, Attr, Text 等 
Node 对 象 的 子 对 象 来 操作 文档 。Node 对 象 为 这 些 对 象 提 供 了 一 个 抽象 的 .公共 的 根 。 虽 
然 在 Node 对 象 中 定义 了 对 其 子 节点 进行 存 取 的 方法 ,但 是 有 一 些 Node 子 对 象 ,例如 Text 
对 象 , 它 并 不 存在 子 节点 ,这 一 点 是 要 注意 的 。 
Node 接口 提供 的 重要 方法 包括 以 下 几 种 。 
* appendChild(org. w3c. dom. Node) : 为 这 个 节点 添加 一 个 子 节点 ,并 放 在 所 有 子 节 
点 的 最 后 。 如 果 这 个 子 节点 已 经 存在 , 则 先 把 它 删 掉 再 添加 进去 。 
getFirstChild(): 如 果 节 点 存在 子 节点 , 则 返回 第 一 个 子 节点 。 对 等 的 ,还 有 
getLastChild() 方 法 返回 最 后 一 个 子 节点 。 
getNextSiblingO ; 返回 在 DOM 树 中 这 个 节点 的 下 一 个 兄弟 节点 。 对 等 的 ,还 有 
getPreviousSibling() 方 法 返回 其 前 一 个 兄弟 节点 。 
* getNodeNameO ; 根据 节点 的 类 型 返回 节点 的 名 称 。 
* getNodeTypeO ; 返回 节点 的 类 型 。 
* getNodeValueO : 返回 节点 的 值 。 
。 hasChildNodesO : 判断 是 不 是 存在 子 节点 。 
。 hasAttributes() : 判断 这 个 节点 是 否 存在 属性 。 
。 getOwnerDocumentO ; 返回 节点 所 处 的 Document 对 象 。 
* insertBefore(org. w3c. dom. Node new,org. w3c. dom. Node ref); 在 给 定 的 一 个 子 
对 象 前 再 插入 一 个 子 对 象 。 
removeChild(org. w3c. dom. Node): 删除 给 定 的 子 节点 对 象 。 
replaceChild (org. w3c. dom. Node new, org. w3c. dom. Node old): 用 一 个 新 的 
Node 对 象 代替 给 定 的 子 节点 对 象 。 
(3) NodeList 
NodeList 对 象 代 表 了 一 个 包含 一 个 或 者 多 个 Node 的 列表 。 可 以 简单 地 把 它 看 成 一 个 
Node 的 数组 。 
NodeList 接口 提供 的 重要 方法 包括 以 下 几 种 。 
* GetLengthO ; 返回 列表 的 长 度 。 
* ItemCGnO ; 返回 指定 位 置 的 Node 对 象 。 
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(4) Element 

Element 对 象 代 表 的 是 XML 文档 中 的 标签 元 素 ,继承 自 Node, 亦 是 Node 的 最 主要 的 
子 对 象 。 在 标签 中 可 以 包含 属性 ,因而 Element 对 象 中 有 存 取 其 属性 的 方法 ,而 任何 Node 
中 定义 的 方法 也 可 以 用 在 Element 对 象 上 面 。 

Element 接口 提供 的 重要 方法 包括 以 下 几 种 。 

* getElementsByTagName(String): 返回 一 个 NodeList 对 象 , 它 包 含 了 在 这 个 标签 
之 下 的 子孙 节点 中 具有 给 定 标签 名 字 的 标签 。 
getTagName(): 返回 一 个 代表 这 个 标签 名 字 的 字符 串 。 
getAttribute(String): 返回 标签 中 给 定 属性 名 称 的 属性 值 。 需 要 注意 的 是 ,XML 
文档 中 应 允许 有 实体 属性 出 现 ,而 这 个 方法 对 这 些 实体 属性 并 不 适用 。 这 时 候 需要 
用 getAttributeNodes() 方 法 来 得 到 一 个 Attr 对 象 进行 进一步 的 操作 。 
getAttributeNode(String): 返回 一 个 代表 给 定 属性 名 称 的 Attr MA, 

(5) Attr 

Attr 对 象 代表 了 某 个 标签 中 的 属性 。Attr 继承 自 Node, 但 是 因为 Attr 实际 上 是 包含 
在 Element 中 的 , 它 并 不 能 被 看 作 Element 的 子 对 象 ,因而 在 DOM 中 Attr 并 不 是 DOM 树 
的 一 部 分 ,所 以 Node 中 的 getParentNode() .getPreviousSibling() 和 getNextSibling() 返 回 
的 都 将 是 null。 也 就 是 说 ,Attr 其 实 是 被 看 作 包 含 它 的 Element 对 象 的 一 部 分 , 它 并 不 作为 
DOM 树 中 单独 的 一 个 节点 出 现 。 这 一 点 在 使 用 的 时 候 要 同 其 他 Node 子 对 象 相 区 别 。 

Attr 接口 提供 的 重要 方法 包括 以 下 几 种 。 

* getName(): 返回 此 属性 的 名 称 。 
getOwnerElement(): 此 属性 连接 到 的 Element 节点 。 如 果 未 使 用 此 属性 , 则 为 
null, 
getSchemaTypeInfoO : 与 此 属性 相关 联 的 类 型 信息 。 
getSpecified OO : 如 果 在 实例 文档 中 显 式 给 此 属性 一 个 值 , 则 为 True; 否则 为 False。 
getValueO ; 检索 时 ,该 属性 值 以 字符 串 形 式 返回 。 
isIdO : 返回 此 属性 是 否 属于 类 型 ID( 即 包含 其 所 有 者 元 素 的 标识 符 ) 。 
* setValue(String value): 检索 时 ,该 属性 值 以 字符 串 形式 返回 。 
下 面 的 serialize() 方 法 演示 了 将 List 集合 数据 生成 XML 文件 的 方法 。 


01 @Override 
02 public String serialize(List < Book> books) throws Exception { 


03 DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance(); 
04 DocumentBuilder builder - factory.newDocumentBuilder(); 

05 Document doc = builder. newDocument() ; 

06 

07 Element rootElement = doc. createElement("books") ; 

08 

09 for (Book book : books) ( 

10 Element bookElement - doc.createElement("book"); 

11 bookElement.setAttribute("id", book.getId() * ""); 


12 
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13 Element nameElement - doc.createElement("name"); 

14 nameElement. setTextContent( book. getName() ) ; 

15 bookElement.appendChild(nameElement); 

16 

17 Element priceElement = doc.createElement("price"); 

18 priceElement. setTextContent(book.getPrice() * ""); 

19 bookElement.appendChild(priceElement); 

20 

21 rootElement. appendChild( bookElement) ; 

22 f 

23 

24 doc. appendChild(rootElement) ; 

25 

26 TransformerFactory transFactory = TransformerFactory. newInstance( ) ; 
27 Transformer transformer = transFactory. newTransformer(); 

28 transformer. setOutputProperty(OutputKeys. ENCODING, "UTF - 8"); 
29 transformer. setOutputProperty(OutputKeys. INDENT, "yes"); 

30 transformer. setOutputPropert y( OutputKeys. OMIT XML DECLARATION, "no") ; 
31 

32 StringWriter writer = new StringWriter(); 

33 

34 Source source = new DOMSource( doc); 

35 Result result = new StreamResult(writer); 

36 transformer. transform(source, result); 

37 

38 return writer. toString(); 

390 

2. SAX 解析 


SAX(Simple API for XML) 解 析 器 是 一 种 基于 事件 驱动 的 解析 器 。 所 谓 事件 驱动 ,就 
是 它 不 用 解析 完整 个 文档 ,在 按 内 容 顺 序 解析 文档 过 程 中 ,SAX 会 判断 当前 读 到 的 字符 是 
T XML 文件 语法 中 的 某 部 分 。 如 果 符 合 某 部 分 , 则 会 触发 事件 。 所 谓 触发 事件 ,就 是 
调用 一 些 回调 方法 ,用 SAX 解析 XML 文档 时 ,在读 取 到 文档 开始 和 结束 标签 时 就 会 回调 
一 个 事件 ,在 读 取 到 其 他 节点 与 内 容 时 也 会 回调 一 个 事件 。 在 事件 源 调用 事件 处 理 器 中 特 
定 方法 的 时 候 , 还 要 传递 给 事件 处 理 器 相应 事件 的 状态 信息 ,这 样 事件 处 理 器 才能 够 根据 提 
供 的 事件 信息 来 决定 自己 的 行为 。 
SAX 从 根本 上 解决 了 DOM 在 解析 XML 文档 时 产生 的 占用 大 量 资源 的 问题 。 其 实 
现 是 通过 类 似 于 流 解 析 的 技术 ,通读 整个 XML 文档 树 ,通过 事件 处 理 器 来 响应 程序 员 对 
于 XML 数据 解析 的 需求 。 由 于 其 不 需要 将 整个 XML 文档 读 人 内 存 中 , 它 对 系统 资源 的 
节省 是 显而易见 的 。SAX 解析 方式 适合 于 大 型 XML 文件 解析 、 只 需要 部 分 解析 或 者 只 
想 取 得 部 分 XML WARA XPath 查询 需求 有 自己 生成 特定 XML 树 对 象 模型 需求 的 
情况 。 
SAX 支持 XPath 查询 ,使 得 开发 人 员 处 理 XML 更 加 灵活 和 得 心 应 手 。 但 是 其 仍然 有 
一 些 不 足 之 处 困扰 着 广大 的 开发 人 员 : 首先 , 它 十 分 复杂 的 API 接 口令 人 望 而 生 旦 ; HK, 
由 于 其 是 类 似 流 解析 的 文件 扫描 方式 ,因此 不 支持 应 用 程序 对 XML 树 内 容 结 构 等 的 修改 ， 
37 
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可 能 会 有 不 便 之 处 。 
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SAX 解析 的 基本 步 又: 

(D 创建 一 个 SAXParserFactory 对 象 。 

© 调用 SAXParserFactory 中 的 newSAXParser 方法 创建 一 个 SAXParser WH. 
© 然后 调用 SAXParser 中 的 getXMLReader 方法 获取 一 个 XMLReader 对 象 。 
® 实例 化 一 个 DefaultHandler 对 象 。 

© 连接 事件 源 对 象 XMLReader 到 事件 处 理 类 DefaultHandler 中 。 

© 调用 XMLReader 的 parse 方 法 从 输入 源 中 获取 的 XML 数据 。 

(D 通过 DefaultHandler 返回 需要 的 数据 集合 。 

例如 ,解析 上 例 中 的 XML 文档 books. xml,parse() 方 法 代码 如 下 : 


01 @Override 
02 public List < Book > parse(InputStream is) throws Exception { 


03 SAXParserFactory factory = SAXParserFactory.newInstance(); 
04 SAXParser parser = factory. newSAXParser() ; 

05 XMLContentHandler handler = new XMLContentHandler() ; 

06 parser. parse(is, handler); 

07 

08 return handler. getBooks() ; 

09 ] 


其 中 的 XMLContentHandler 代码 如 下 : 


01 class XMLContentHandler extends DefaultHandler { 


02 

03 private List < Book > books; 

04 private Book book; 

05 private StringBuilder builder; 

06 

07 public List < Book > getBooks() { 

08 return books; 

09 } 

10 

at @Override 

12 public void startDocument() throws SAXException { 

13 super. startDocument( ) ; 

14 books = new ArrayList < Book >(); 

15 builder = new StringBuilder(); 

16 } 

17 

18 @Override 

19 public void startElement(String uri, String localName, String qName, 
20 Attributes attributes) throws SAXException { 
2i super.startElement(uri, localName, qName, attributes); 
22 if (localName. equals("book")) { 

23 book - new Book(); 
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24 } 

25 builder. setLength(0); 

26 } 

27 

28 @Override 

29 public void characters(char[] ch, int start, int length) 

30 throws SAXException { 

31 super. characters(ch, start, length); 

32 builder. append(ch, start, length); 

33 } 

34 

35 @Override 

36 public void endElement(String uri, String localName, String qName) 
ay throws SAXException { 

38 super.endElement(uri, localName, qName); 

39 if (localName. equals(" id")) ( 

40 book. setId(Integer. parseInt(builder. toString())); 
41 } else if (localName. equals("name")) { 

42 book. setName( builder. toString()); 

43 } else if (localName. equals("price")) { 

44 book. setPrice(Float. parseF loat (builder. toString())); 
45 } else if (localName. equals("book")) { 

46 books. add( book) ; 

47 } 

48 } 

49 } 


下 面 介 绍 org. xml. sax 包 的 API. 

在 SAX 接口 中 ,事件 源 是 org. xml. sax 包 中 的 XMLReader, 它 通过 parser() 方 法 来 解 
析 XML 文档 ,并 产生 事件 。 事件 处 理 器 是 org. xml. sax 4P ContentHander, DTDHander, 
ErrorHandler 以 及 EntityResolver 这 4 个 接口 。 

DefaultHandler 是 一 个 事件 处 理 器 ,可 以 接收 解析 器 报告 的 所 有 事件 ,处 理 所 发 现 的 数据 。 
它 实现 了 ContentHandler 接口 . DTDHandler # H , ErrorHandler 接口 和 EntityResolver 
接口 。 这 几 个 接口 代表 不 同类 型 的 事件 处 理 器 。 这 4 个 接口 的 详细 说 明 如 表 2-2 所 示 。 

表 2-2 org. xml. sax 包 中 的 事件 处 理 器 
事件 处 理 器 名 称 事件 处 理 器 处 理 的 事件 XMLReader 注册 方法 





跟 文档 内 容 有 关 的 所 有 事件 : 
COD 文档 的 开始 和 结束 。 

(2) XML 元 素 的 开始 和 结束 。 
ContentHander (3) 可 忽略 的 实体 。 setContentHandler(ContentHandler h) 
(4) 名 称 空 间 前 缀 映射 的 开始 和 结束 。 
(5) 处 理 指 令 。 

(6) 字符 数据 和 可 忽略 的 空格 
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续 表 
事件 处 理 器 名 称 事件 处 理 器 处 理 的 事件 XMLReader 注册 方法 
DTDHander 处 理 对 文档 DTD 进行 解析 时 产生 的 相 setDTDHandler(DTDHandler h) 
应 事件 
处 理 XML 文档 解析 时 产生 的 错误 。 如 
ErrorHandler 果 一 个 应 用 程序 没有 注册 一 个 错误 处 | setErrorHandler(ErrorHandler h) 
理 器 类 ,会 发 生 不 可 预料 的 解析 器 行为 
EntityResolver 处 理 外 部 实体 setEntityResolver( EntityResolver e) 

















ContentHandler 接口 常用 的 方法 包括 以 下 几 种 。 

* startDocument() : 当 遇 到 文档 开头 的 时 候 , 调 用 这 个 方法 ,可 以 在 其 中 做 一 些 预 处 
理 的 工作 。 

* endDocument(): 当 文 档 结 束 的 时 候 , 调 用 这 个 方法 ,可 以 在 其 中 做 一 些 善后 的 
IM. 

* startElement(String namespaceURI, String localName, String qName, Attributes 
atts): 当 读 到 开始 标签 的 时 候 , 会 调用 这 个 方法 。namespaceURI 就 是 命名 空间 ， 
localName 是 不 带 命名 空间 前 级 的 标签 名 ,qName 是 带 命 名 空间 前 缀 的 标签 名 。 通 
过 atts 可 以 得 到 所 有 的 属性 名 和 相应 的 值 。 

* endElement(String uri, String localName, String name); 在 遇 到 结束 标签 的 时 候 ， 
调用 这 个 方法 。 

。 characters(char[] ch, int start, int length): 这 个 方法 用 来 处 理 在 XML 文件 中 读 
到 的 内 容 。 例 如 : <high data 二 "30"/ 志 主要 目的 是 获取 high 标签 中 的 值 。 第 一 个 
参数 用 于 存放 文件 的 内 容 ,后面 两 个 参数 是 读 到 的 字符 串 在 这 个 数组 中 的 起 始 位 置 
和 长 度 ,使 用 new String(ch,start,length) 就 可 以 获取 内 容 。 

HEM: SAX 的 一 个 重要 特点 就 是 它 的 流 式 处 理 , 当 遇 到 一 个 标签 的 时 候 , 它 并 不 会 记 

录 下 之 前 所 碰 到 的 标签 , 即 在 startElement() 方 法 中 ,所 有 能 够 知道 的 信息 ,就 是 标签 的 名 
字 和 属性 。 至 于 标签 的 谋 套 结构 、 上 层 标签 的 名 字 、 是 否 有 子 元 素 等 其 他 与 结构 相关 的 信 
息 , 都 是 不 知道 的 ,都 需要 程序 来 完成 。 这 使 得 SAX 在 编程 处 理 上 没有 DOM 方便 。 
表 2-3 列 出 了 SAX 和 DOM 在 一 些 方面 的 对 照 。 
表 2-3 SAX 和 DOM 对 比 
SAX DOM 
顺序 读 入 文档 并 产生 相应 事件 ,可 以 处 理 任 何 大 
小 的 XML 文档 
只 能 对 文档 按 顺 序 解析 一 遍 ,不 支持 对 文档 的 随 
意 访问 
只 能 读 取 XML 文档 内 容 ,而 不 能 修改 可 以 随意 修改 文档 树 ,从 而 修改 XML 文档 
开发 上 比较 复杂 ,需要 自己 来 实现 事件 处 理 器 易于 理解 ,易于 开发 
对 开发 人 员 而 言 更 灵活 ,可 以 用 SAX 创建 自己 
的 XML 对 象 模型 





在 内 存 中 创建 文档 树 ,不 适 于 处 理 大 型 XML 文档 





可 以 随意 访问 文档 树 的 任何 部 分 ,没有 次 数 限制 











已 经 在 DOM 基础 之 上 创建 好 了 文档 树 
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3. PULL 解析 
PULL 解析 器 的 运行 方式 和 SAX 类 似 ,都 是 基于 事件 的 模式 。 不 同 的 是 ,在 PULL fet 
析 过 程 中 ,需要 自己 获取 产生 的 事件 然后 做 相应 的 操作 ,而 不 像 SAX 那样 由 处 理 器 触发 一 
种 事件 的 方法 来 执行 相应 的 工作 。PULL 解析 器 小 巧 轻便 ,解析 速度 快 ,简单 易 用 ,非常 适 
合 在 Android 移动 设备 中 使 用 , Android 系统 内 部 在 解析 各 种 XML 时 也 是 用 PULL 解 
析 器 。 
Pull 解析 是 一 个 遍历 文档 的 过 程 ,每 次 调用 next O , nextTag OO , nextToken C) 和 
nextText() 都 会 向 前 推进 文档 ,并 使 Parser 停留 在 某 些 事 件 上 面 ,但 是 不 能 倒退 。 然 后 把 
文档 设置 给 Parser。 
Android 中 对 Pull 方法 提供 了 支持 的 API, 常 用 的 XML PULL 的 接口 和 类 包括 以 下 
几 种 。 
。 XmlPullParser: 该 解析 器 是 一 个 在 org. xmlpull. vl 中 定义 的 解析 功能 的 接口 。 应 
用 程序 通过 调用 XmlPullParser. next() 等 方法 来 产生 Event, 然 后 再 处 理 Event, 

* XmlSerializer; 它 是 一 个 接口 ,定义 了 XML 信息 集 的 序列 。 

* XmlPullParserFactory; 这 个 类 用 于 在 XMPULL V1 API 中 创建 XML Pull 解 
析 器 。 

* XmlPullParserException; 抛 出 单一 的 与 XML pull 解析 器 相关 的 错误 。 

例如 ,解析 上 例 中 的 XML 文档 books. xml,parse() 方 法 代码 如 下 : 


01 @Override 
02 public List < Book > parse(InputStream is) throws Exception { 


03 List < Book > books = null; 

04 Book book = null; 

05 

06 XmlPullParser parser = Xml. newPullParser(); 

07 parser.setInput(is, "UTF - 8"); 

08 int eventType = parser.getEventType(); 

09 

10 while (eventType != XmlPullParser. END_DOCUMENT) { 

it switch (eventType) { 

12 case XmlPullParser.START DOCUMENT: 

13 books = new ArrayList < Book >(); 

14 break; 

15 case XmlPullParser. START_TAG: 

16 if (parser. getName( ). equals("book")) ( 

iG} book = new Book() ; 

18 } else if (parser. getName().equals("id")) { 
19 eventType = parser. next(); 

20 book. setId( Integer. parseInt( parser. getText())); 
21 } else if (parser. getName().equals("name")) { 
22 eventType = parser. next(); 

23 book. setName( parser. getText()) ; 

24 } else if (parser. getName().equals("price")) { 
25 eventType = parser. next(); 
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26 book. setPrice(Float. parseFloat(parser.getText())); 
27 } 

28 break; 

29 case XmlPullParser. END_TAG: 

30 if (parser. getName().equals("book")) { 
31 books. add( book) ; 

32 book = null; 

33 } 

34 break; 

35 } 

36 eventType = parser. next(); 

a } 

38 

39 return books; 


40 } 


文档 刚 被 初始 化 时 ,事件 为 START _ DOCUMENT, 可 以 通过 XmlIPullParser. 
getEventType() 来 获取 。 然 后 调用 next() 会 产生 START. TAG ,这 个 事件 告诉 应 用 程序 一 
个 标签 已 经 开始 了 ,调用 getName() 会 返回 book; #4 TEXT. Ill] next() 会 产生 TEXT 事 
件 ,调用 getText() 会 返回 TEXT。 如 果 没 有 , 则 next() 会 产生 END_TAG ,说明 一 个 标签 
已 经 处 理 完了 。 循 环 调用 next() 直 到 最 后 处 理 完 TAG, 会 产生 END DOCUMENT , iji BH 
整个 文档 已 经 处 理 完成 了 。 除 了 next 〇 以 外 ,nextToken() 也 可 以 使 用 ,只 不 过 它 会 返回 更 
加 详细 的 事件 ,例如 COMMENT,CDSECT.DOCDECL,ENTITY 等 非常 详细 的 信息 。 如 
果 程 序 得 到 比较 底层 的 信息 ,可 以 用 nextToken() 来 驱动 并 处 理 详 细 的 事件 。 需 要 注意 的 
一 点 是 ,TEXT 事件 是 有 可 能 返回 空白 的 (如 换行 符 或 空格 等 ) 。 

nextTag() 方 法 会 忽略 空白 。 如 果 可 以 确定 下 一 个 是 START_TAG 或 END_TAG ,就 
可 以 调用 nextTag() 直 接 跳 过 去 。 通 常 它 有 两 个 用 处 : A START. TAG 时 ,如 果 能 确定 
这 个 TAG 含有 子 TAG, 那 么 就 可 以 调用 nextTag() 产 生子 标签 的 START_TAG 事件 ; 当 
Jy END. TAG 时 ,如 果 确 定 不 是 文档 结尾 ,就 可 以 调用 nextTag() 产 生 下 一 个 标签 的 
START TAG. 在 这 两 种 情况 下 ,如 果 用 nextO SA TEXT 事件 ,但 返回 的 是 换行 符 或 空 
白 符 。 

nextText() 方 法 只 能 在 START. TAG 时 调用 。 当 下 一 个 元 素 是 TEXT 时 ,TEXT 的 
内 容 会 返回 ; 当下 一 个 元 素 是 END. TAG 时 ,也 就 是 说 这 个 标签 的 内 容 为 空 ,那么 返回 空 
FP; 这 个 方法 返回 后 ,Parser 会 停留 在 END_TAG E. 


2.2 JSON 数据 解析 


JSON 为 Web 应 用 开发 者 提供 了 另 一 种 数据 交换 格式 , 同 XML 或 HTML 片段 相 比 ， 
JSON 提供 了 更 好 的 简单 性 和 灵活 性 。 
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2.2.1 JSON 介绍 


JSON (JavaScript Object Notation) 是 一 种 轻 量 级 的 数据 交换 格式 ,具有 良好 的 可 读 性 
和 便于 快速 编写 的 特性 ,同时 也 易于 机 器 解析 和 生成 ,非常 适合 于 服务 器 与 客户 端的 交互 。 
JSON 采用 与 编程 语言 无 关 的 文本 格式 ,业内 主流 技术 为 其 提供 了 完整 的 解决 方案 (有 点 类 
似 于 正则 表达 式 ), 从 而 可 以 在 不 同 平台 间 进 行 数据 交换 。JSON 采用 兼容 性 很 高 的 文本 格 
式 吕 ,同时 也 具备 类 似 于 C 语言 体系 的 行为 。 

1. JSON 的 数据 结构 

与 XML 一 样 ,JSON 也 是 基于 纯 文本 的 数据 结构 (注意 : JSON 并 不 是 一 个 文档 格式 ， 
WA x. json 的 文档 ,一 般 JSON 格式 的 文档 存在 txt 文件 中 ) 。 

JSON 有 以 下 两 种 数据 结构 。 

(D Map 

Map 结构 也 称 为 对 象 ,以 键 值 对 的 形式 给 出 , 键 和 值 之 间 用 “:” 隔 开 , 两 个 Map 之 间 用 
“,” 隔 开 ,一 般 表示 形式 如 下 : 


{'keyl':'valuel', 'key2': 'value2'} 


图 2-1 演示 了 这 种 组 织 形 式 。 


object f 
| 















































O [ string O value G4 
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图 2-1 JSON Map 结构 
(2) Array 
Array 就 是 普通 意义 上 的 数组 ,一 般 形式 如 下 : 
Warritotarr2Ufarr3307 
图 2-2 演示 了 这 种 组 织 形 式 。 
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图 2-2 JSON Array 结构 


说 明 : ISON 可 以 说 套 表示 ,例如 Array P TARA Object. 

2. JSON 的 数据 格式 

由 于 JSON 天 生 是 为 JavaScript 准备 的 ,因此 ,JSON 的 数据 格式 非常 简单 ,可 以 用 
JSON 传输 一 个 简单 的 String, Number, Boolean ,也 可 以 传输 一 个 数组 ,或 者 一 个 复杂 的 
Object 对 象 。 


© http://www. json. org. cn/tools/JSONEditorOnline2. 0/index. htm 提供 了 JSON 在 线 编辑 工具 。 
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* 对 象 (Object) : 一 个 对 象 以 “{” 开 始 ,并 以 “)” 结 束 。 一 个 对 象 包含 一 系列 非 排序 的 键 
值 对 ,每 个 键 值 对 之 间 使 用 ,分 隔 。 此 处 的 Object 相当 于 Java 中 的 Map< String, 
Object ,而 不 是 Java 的 Class。 例 如 ,一 个 Address 对 象 包含 如 下 键 值 对 : 


{"city" :"Beijing", "street" :" Chaoyang Road ", "postcode" :100025} 


其 中 Value 也 可 以 是 另 一 个 Object 或 者 数组 。 因 此 ,复杂 的 Object TUMRMERA, 
例如 ,一 个 Person 对 象 包含 name 和 address 对 象 ,可 以 表示 如 下 : 


{"name" : "Michael","address": {"city":"Beijing", "street":" Chaoyang Road ","postcode" :100025]] 


* 名 称 一 值 CCollection): 4 f AA zz [8] (EA: "PRE ,一 般 的 形式 是 : (name: value}, 
个 名 称 是 一 个 字符 串 ; 一 个 值 可 以 是 一 个 字符 串 .一 个 数值 一 个 对 象 .一 个 布尔 
值 、 一 个 有 序列 表 ,或 者 一 个 null 值 , 如 {"firstName":"Brett"} 。 
。 数组 (Array) : 使 用 [ ] 包 含 所 有 元 素 ,每 个 元 素 用 逗号 分 隔 ,元 素 可 以 是 任意 的 
Value, 例 如 ,以 下 数组 包含 了 一 个 String、Number、Boolean 和 一 个 null 








[ "abc" , 12345 , false , null] 


* FRE (CString): 以 "" 括 起 来 的 一 串 字 符 。 除 了 字符 "、\、/ 和 一 些 控制 符 (\b、\f、 
\n,\r,\) 需 要 编码 外 ,其 他 Unicode 字符 可 以 直接 输出 。 

* 数值 (Number) ; 一 系列 0 一 9 的 数字 组 合 ,可 以 为 负数 或 者 小 数 。 还 可 以 用 e 或 者 

* 布尔 值 (Boolean) : 表示 为 true 或 者 false。 在 很 多 语言 中 它 被 解释 为 数组 。 

注意 : true false 都 没有 双 引 号 ,否则 将 被 视 为 一 个 字符 串 。 

3. 生成 JSON 

(1) 使 用 String 生成 JSON 

将 String 对 象 编码 为 JSON 格式 时 ,只 需 处 理 好 特殊 字符 即 可 。 另 外 ,必须 用 双 引 号 


表示 字符 串 , 例 如 ， 
01 static String string2Json(String s) { 
02 StringBuilder sb = new StringBuilder(s. length() + 20); 
03 Sb. append( V" '); 
04 for (int i=0; i<s.length(); i++) { 
05 char c = s.charAt(i); 
06 switch (c) { 
07 case '\"': 
08 sb. append("\\\""); 
09 break; 
10 case '\\': 
11 sb. append("\\\\"); 
12 break; 
13 case '/': 
14 sb. append("\\/"); 
15 break; 
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16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
3T 
32 
33 
34 
35 
36 
3T 


case '\b': 
sb. append( "WV b") ; 
break; 
case '\f': 
sb. append("\\£") ; 
break; 
case '\n': 
sb. append("\\n") ; 
break; 
case '\r': 
sb. append("\\r") ; 
break; 
case 'Nt': 
sb. append("\\t") ; 
break; 
default: 
sb. append(c) ; 
} 
} 
Sb. append( V" '); 
return sb. toString(); 


(2) 使 用 Number /E sk JSON 
利用 Java 的 多 态 性 ,可 以 处 理 Integer, Long, Float 等 多 种 Number 格式 ,例如 : 


static String number2Json(Number number) { 


return number. toString(); 


(3) 使 用 数组 生成 JSON 
通过 循环 将 数组 的 每 一 个 元 素 编码 出 来 生成 JSON ,例如 ， 


01 static String array2Json(Object[] array) { 
02 if (array.length-- 0) 

03 return "[]"; 

04 StringBuilder sb = new StringBuilder(array. length << 4); 
05 sb. append( '[ ') ; 

06 for (Object o : array) ( 

07 sb. append(toJson(o)) ; 

08 sb. append(', '); 

09 i 

10 // 将 最 后 添加 的 ',' 变 为 '"] ' : 

sb. setCharAt(sb. length() - 1, ']'); 

12 return sb. toString(); 

13 

其 中 的 toJson() 方 法 代码 如 下 : 


01 public static String toJson(Object o) { 


02 


if (o==null) 
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03 
04 
05 


return "null"; 
if (o instanceof String) 
return string2Json((String)o); 
if (o instanceof Boolean) 
return boolean2Json( (Boolean)o); 
if (o instanceof Number) 
return number2Json( ( Number)o) ; 
if (o instanceof Map) 
return map2Json( (Map < String, Object >)o); 
if (o instanceof Object[]) 
return array2Json((Object[ ]) o) ; 
throw new RuntimeException("Unsupported type: " 
+ o.getClass().getName()) ; 


(4) fit i Map< String, Object>4: hw JSON 
与 数组 类 似 , 通 过 遍历 Map 对 象 来 生成 JSON ,例如 : 


static String map2Json(Map< String, Object > map) { 


if (map. isEnpty()) 
return "{}"; 
StringBuilder sb = new StringBuilder(map. size() << 4); 
sb. append( '(*); 
Set < String > keys = map.keySet(); 
for (String key : keys) { 
Object value = map.get(key); 
sb. append('\"'); 
sb. append(key) ; 
sb. append('\"") ; 
sb. append(':'); 
sb. append(toJson(value) ) ; 
sb. append(', '); 
h 
// 将 最 后 的 '，' 变 为 "} ': 
Sb. setCharAt(sb. length() - 1, '}'); 
return sb. toString(); 


2.2.2 JSON 核心 解析 类 


Android 的 JSON 解析 部 分 都 在 org. json 包 下 ,主要 有 以 下 几 个 类 。 

1. JSONObject 

JSONObject 是 一 个 无 序 的 键 值 对 的 集合 ,可 以 看 作 一 个 JSON 对 象 ,这 是 系统 中 有 关 
JSON 定义 的 基本 单元 。 它 的 外 在 形式 是 一 个 用 大 括号 包 庄 ,并 用 冒号 将 名 字 和 值 分 开 的 
字符 串 。 内 部 形式 就 是 一 个 对 象 。 

JSONObject 提供 了 一 系列 的 get、set 和 opt 方法 来 访问 JSONObject 实例 。 这 些 值 的 
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类 型 可 以 是 Boolean, JSONArray , JSONObject, Number, String 或 者 默认 值 JSONObject. 


NULL 对 象 。 
JSONObject 有 两 个 不 同 的 取 值 方法 : 


。 getType 可 以 将 要 获取 的 键 值 转换 为 指定 的 类 型 ,如 果 无 法 转换 或 没有 值 , 则 抛 出 


JSONExXxception, 


* optType 也 是 将 要 获取 的 键 值 转换 为 指定 的 类 型 ,无 法 转换 或 没有 值 时 ,返回 用 户 


提供 或 者 默认 提供 的 值 。 


在 使 用 JSONObject 时 ,一 般 先 创建 一 个 JSONObject 对 象 后 ,再 使 用 put (String, 
Object) 等 方法 添加 键 值 对 ,最 后 使 用 toString() 方 法 将 JSONObject 对 象 按照 JSON 的 标 


准 格式 进行 封装 。 


例如 ,下 面 的 代码 用 于 创建 一 个 JSONObject 对 象 : 


01 private JSONObject createJSONObject() { 


02 JSONObject person = new JSONObject(); 
03 try { 

04 JSONArray phone = new JSONArray(); 
05 phone. put ("12345678") ; 

06 phone. put ("87654321") ; 

07 person. put("phone", phone); 

08 person. put("name", "liweiyong"); 

09 person. put("age", 100); 

10 JSONObject address = new JSONObject() ; 
11 address. put("country", "china"); 

12 address. put("province", "jiangsu"); 
13 person. put("address", address); 

14 person. put("married", false); 

15 ) catch (JSONException e) ( 

16 e.printStackTrace(); 

17 } 

18 return person; 

19 } 

创建 的 JSON 对 象形 式 如 下 : 


("phone" :["12345678", "87654321" ], 

"married" :false, 

"address" : (" province" :"jiangsu", "country" :" china"), 
"age" :100, 

"name" :"liweiyong" 


} 


2. JSONStringer 


// 数 组 

// 布 尔 值 
// ISON 对 象 
// 数 值 

// 字 符 串 


JSONStringer 是 JSON 文本 构建 类 ,用 于 帮助 快速 和 便捷 地 创建 JSON 文本 。 其 最 大 的 
优点 在 于 可 以 减少 由 于 格式 的 错误 而 导致 程序 异常 ,引用 这 个 类 可 以 自动 严格 按照 JSON 语 
法 规则 创建 JSON 文本 。 每 个 JSONStringer 实体 只 能 对 应 创建 一 个 JSON 文本 。 例 如: 
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01 
02 
03 
04 
05 
06 
07 
08 


try { 
String myString = new JSONStringer(). object() 
. key(" id"). value("20120226") 
. key("name") . value("1xb") 
. endObject(). toString( ) ; 
} catch (JSONException ex) { 
throw new RuntimeException(ex) ; 
} 


结果 是 一 组 标准 格式 的 JSON 文本 : {"id" : "20120226","name" ; "1xb"}。 为 了 按照 
Object 标准 给 数值 添加 边界 ,. object() 和 . endObject() 必 须 同 时 使 用 。 同 样 , 针 对 数组 也 有 
一 组 标准 的 方法 . array() 和 .endArray() 来 生成 边界 。 

3. JSONArray 

JSONArray 代表 一 组 有 序 的 数值 。 表 现形 式 是 用 方 括号 包 庄 ,数值 以 “, ”分隔 ( 例 如 : 
[valuel,value2 ,value3]) 。 这 个 类 的 内 部 同样 具有 查询 行为 ,通过 get() 和 opt() 两 种 方法 
都 可 以 根据 index 索引 返回 指定 的 数值 ,put() 方 法 用 来 添加 或 者 替换 数值 。 这 个 类 和 
JSONObject 支持 相同 的 数据 类 型 。 

下 面 的 代码 是 对 JSONArray 遍历 的 典型 方式 : 


01 
02 
03 
04 
05 


JSONArray array = JSONArray.fromObject(data); 
for (Object object : array) { 
JSONObject o = JSONObject. fromObject(object) ; 
o.get("key" ) 


4. JSONTokener 
JSONTokener 是 系统 为 JSONObject fll JSON Array 构造 器 的 解析 类 , 它 可 以 从 源 信息 
中 提取 数值 信息 。 例 如 : 


01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 
16 
17 
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private static String getJSONContent( ) ( 
JSONTokener jsonTokener - new JSONTokener(JSONText) ; 
JSONObject studentJSONObject; 
String name - null; 


int id = 0; 
String phone = null; 
try { 


studentJSONObject = (JSONObject) jsonTokener. nextValue( ); 
name = studentJSONObject. getString( "name" ) ; 
id = studentJSONObject. getInt ("id"); 
phone = studentJSONObject. getString("phone"); 
} catch (JSONException e) { 
e. printStackTrace( ) ; 
J 


return name + "" + id + "" + phone; 
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5. SONException 

JSONException # json. org 类 抛 出 的 异常 信息 。 当 语法 错误 或 者 过 程 异常 的 时 候 , 会 
抛 出 JSONException 异常 。 

以 下 情况 下 会 产生 JSONException : 

。 试图 解析 或 构建 一 个 格式 错误 的 JSON 文档 。 

。 使 用 null 作为 关键 词 。 

。 使 用 时 不 提供 给 JSON 数值 类 型 ,如 NaN 或 无 穷 大 的 。 

。 使 用 不 存在 的 键 进行 查找 。 

。 类 型 不 匹配 的 解析 。 

6. JSONString 

JSONString 是 一 个 接口 ,以 便 其 他 类 可 以 通过 实现 该 接口 的 toString() 方 法 来 改变 
JSONObject,J SONArray 等 内 部 toString() 方 法 的 功能 ,以 实现 它们 自己 的 序列 化 。 

7. JSONWriter 

JSONWriter 位 于 android. util 包 下 ,是 一 个 快速 将 JSON 文本 写 入 数据 流 的 工具 。 每 
次 只 能 输出 一 个 字符 串 。 流 中 既 包括 文字 值 ( 字 符 串 、 数 字 , 布 尔 值 和 空 值 ), 也 包括 作为 对 
象 .数组 的 开始 和 结束 标志 的 分 隔 符 。 

例如 ,下 面 的 writeJsonStream() 方 法 主要 是 利用 JsonWriter 把 联系 人 的 信息 写 入 文件 
流 中 : 


01 private void writeJsonStrean() { 


02 ByteArrayOutputStream out = new ByteArrayOutputStream(); 

03 JsonWriter writer = new JsonWriter(new OutputStreamWriter(out, "UTF - 8")); 
04 

05 Cursor cur = context.getContentResolver().query( 

06 ContactsContract. Contacts. CONTENT URI, 

07 null, 

08 null, 

09 null, 

10 ContactsContract. Contacts.DISPLAY NAME 

PD * " COLLATE LOCALIZED ASC"); 

12 

13 if (cur != null && cur.moveToFirst()) { 

14 int idColumn - cur.getColumnIndex(ContactsContract.Contacts. ID); 
i5 

16 int displayNameColumn = cur 

17 . getColumnIndex(ContactsContract. Contacts.DISPLAY NAME); 
18 writer. setIndent(" "); 

19 writer. beginObject(); 

20 writer. name(ContactStruct. CONTACTS) ; 

21 writer. beginArray(); 

22 

23 do { 

24 writer. beginObject(); 

25 String contactId = cur. getString(idColumn) ; 

26 writer. name(ContactStruct. ID). value(contactId) ; 
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27 String disPlayName - cur.getString(displayNameColumn); 

28 writer. name(ContactStruct. NAME). value(disPlayName); 

29 int phoneCount = cur.getInt(cur.getColumnIndex( 

30 ContactsContract. Contacts.HAS PHONE NUMBER)); 

31 Log. i("username", disPlayName); 

32 if (phoneCount » 0) ( 

33 Cursor phones = context. getContentResolver().query( 

34 ContactsContract.CommonDataKinds. Phone. CONTENT URI, 
35 null, 

36 ContactsContract.CommonDataKinds. Phone. CONTACT ID 
37 +" =" + contactId, null, null); 

38 if (phones != null && phones. moveToFirst()) { 

39 writer. name(ContactStruct. PHONENUMBERS) ; 

40 writer. beginArray() ; 

4l do ( 

42 writer.beginObject(); 

43 String phoneNumber - phones.getString(phones 

44 . getColumnIndex(ContactsContract 

45 . CommonDataKinds. Phone. NUMBER) ) ; 
46 String phoneType = phones. getString( phones 

47 . getColumnIndex(ContactsContract 

48 . CommonDataKinds. Phone. TYPE) ) ; 
49 writer, name(ContactStruct. TYPE) . value( phoneType) ; 
50 writer.name(ContactStruct. PHONENUMBER) . value( 

51 phoneNunber) ; 

52 writer. endObject(); 

53 Log.i("phoneNumber", phoneNumber + 

54 Log. i("phoneType", phoneType + ""); 

55 } while (phones. moveToNext( ) ) ; 

56 writer.endArray(); 

57 } 

58 closeCursor(phones) ; 

59 } 

60 } while (cur. moveToNext()); 

61 } 

62 } 


8. JSONReader 


JsonReader 位 于 android. util 包 下 , 主要 用 来 读 取 JSON 字符 串 的 内 容 。 例 如 ,JSON 


字符 串 如 下 : 
01 private static final String JSONString = 


02 "[{\"name\" :\"Michael\",\"age\":20}, 
03 {\"name\" :\"Mike\",\"age\":21}]"; 


TE Activity 中 调用 解析 方法 : 


01 JSONUtils jsonUtils = new JSONUtils(); 
02  jSONUtils.parseJson(JSONString); 
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其 中 的 JSONUtils 代码 如 下 : 


01 public class JSONUtils { 
public void parseJson(String jsonData) { 


02 
03 
04 
05 
06 
07 
08 
09 
10 
"mp 
12 
13 
14 
15 
16 
T 
18 
19 
20 
21 
22 
23 


在 LogCat 中 观察 运行 结果 ,如 图 2-3 所 示 。 


try{ 
JsonReader reader = new JsonReader(new StringReader(jsonData)); 
reader. beginArray(); 
while (reader. hasNext()) { 
reader. beginObject(); 
while (reader. hasNext()) { 
String tagName - reader.nextName(); 
if (tagName. equals("name")) ( 
System.out.println("name --- >" + reader.nextString()); 
} else if (tagName. equals("age")) { 
System.out.println("age--- »" + reader.nextInt()); 


} 
reader. endObject(); 
} 
reader. endArray(); 
) catch (Exception e) { 
e.printStackTrace(); 





Systen. out nane---»Michael 

最 后 ,演示 一 个 通过 向 中 国 天 气 网 发 送 获取 System. out age---»20 
天 气 信息 的 请 求 , 然 后 解析 获取 的 JSON 数据 并 System. out nane--->Mike 
显示 的 示例 。 System.out age 221 

首先 创建 一 个 如 下 的 请 求 连接 工具 类 HESS. Jeonkcsder Re Ur 
HttUtil ,代码 如 下 : 

01 public class HttUtil { 

02 

03 public static HttpClient httpClient = new DefaultHttpClient(); 

04 

05 "E 

06 * @param url 请 求 地 址 

07 * @return 服务 器 响应 的 字符 串 

08 * @throws InterruptedException 

09 * @throws ExecutionException 

10 «/ 

11 public static String getRequest (final String url) 

12 throws InterruptedException, ExecutionException { 

3 FutureTask < String > task = new FutureTask < String>( 

14 new Callable<String>() { 

15 
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16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 


@Override 
public String call() throws Exception { 

HttpGet get = new HttpGet(url) ; 

HttpResponse httpResponse = httpClient. execute(get) ; 

if (httpResponse. getStatusLine() 

.getStatusCode() == 200) { 
return EntityUtils. toString(httpResponse 
. getEntity()); 


return null; 


p; 


new Thread( task). start(); 
return task. get(); 


然后 实现 如 下 简单 的 Activity 实例 : 


01 public class JSONParsingActivity extends Activity { 


02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 
16 
idm 
18 
2c) 
20 
21 
22 
23 
24 
25 
26 
27 
28 


private TextView showResult; 
@Override 
protected void onCreate( Bundle savedInstanceState) { 
super. onCreate(savedInstanceState) ; 
setContentView(R. layout. activity_jsonparsing) ; 
showResult = (TextView) findViewById(R. id. result); 
WeatherAsyncTask task = new WeatherAsyncTask(); 
task. execute( "http://www. weather. com. cn/data/cityinfo/101010100. html"); 


class WeatherAsyncTask extends AsyncTask «String, Integer, String> { 


public WeatherAsyncTask() { 


super(); 

} 

@Override 

protected String doInBackground(String... params) { 
String result = ""; 
try { 


result = HttUtil. getRequest(params[0]); 
} catch (InterruptedException e) { 
e. printStackTrace( ) ; 





第 2 章 数据 解析 


29 } catch (ExecutionException e) { 

30 e. printStackTrace(); 

31 } 

32 

33 return result; 

34 } 

35 

36 @Override 

37 protected void onPostExecute(String result) { 

38 try { 

39 // 获 取 JSONObject Xj 

40 JSONObject jsonobject = new JSONObject(result); 

41 JSONObject jsoncity = new JSONObject( 

42 jsonobject. getString("weatherinfo")); 

43 showResult. setText(" 城 市 :" + jsoncity.getString("city") + "Wn" 
44 + "气温 :最 高 ”+ jsoncity. getString("temp1") 

45 Hom 最 低 ”+ jsoncity.getString("temp2") + "An" 
46 + "今天 天 气 :”+ jsoncity. getString("weather")); 
47 } catch (JSONException e) { 

48 e. printStackTrace( ) ; 

49 } 

50 } 

51 

52 } 

53 

54 ] 

代码 解析 如 下 : 


12—13 行 创 建 一 个 16—52 行 定义 的 WeatherAsyncTask( 继 承 自 AsyncTask) 实 例 ,并 
调用 其 execute() 方 法 执行 异步 任务 。 

22~34 行 覆盖 的 doInBackground() 方 法 通过 第 26 行 来 向 中 国 天 气 网 请 求 数据 ,并 将 
数据 赋 给 result FIFE ,该 字符 串 的 内 容 类 似 如 下 : 


{"weatherinfo":{"city":" 北 京 "," cityid":" 101010100"," temp1":" 15'C "," temp2":"5T"," 
weather":"Z z","ingl":"dl.gif","img2" :"n1.gif", "ptime":"08:00"}} 


36—50 行 覆盖 的 onPostExecute() 方 法 对 返回 的 结果 result 进行 解析 。 通 过 上 面 的 
result 结果 可 以 看 到 ,JSONObject 对 象 的 一 系列 get 方法 里 的 参数 city, templ, temp2, 
weather 等 都 是 key。 


2.2.3 JSON 解析 工具 


1. Gson 
Android 默认 提供 JSONArray 和 JSONObject 3E ff Br JSON 格式 的 数据 ,但 将 JSON 
转换 为 实体 对 象 时 不 是 很 方便 。Gson® 是 Google 提供 的 一 个 轻 量 级 的 JSON 转换 类 库 ,在 


(D gson.jar 下 载 地 址 : http://code. google. com/p/google-gson/downloads/list. 
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Java 平台 可 以 方便 地 将 一 个 Java 对 象 转换 成 JSON 格式 ,也 可 以 将 JSON 格式 的 字符 串 转 
换 成 Java 对 象 。 

Gson 的 解析 非常 简单 ,但 是 它 的 解析 规则 是 必须 有 一 个 Bean 文件 ,这 个 Bean 文件 的 
内 容 跟 JSON 数据 类 型 是 一 一 对 应 的 。 

假设 JSON 的 数据 格式 如 下 : 
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{ 


“e100 

"body": "It is my post", 

"nunber" : 0.13, 

"created at": "2014 - 05 - 22 19:12:38" 


那么 只 需要 定义 对 应 的 一 个 Bean 类 ,例如 : 


01 
02 
03 
04 
05 
06 


public class FooBean ( 
public int id; 
public String body; 
public float number; 
public String created at; 


下 面 介绍 Gson 解析 JSON 的 三 个 主要 类 。 

A) Gson: 使 用 Gson 的 主 类 ,构造 Gson 类 的 实例 后 ,可 使 用 toJson(Object) 方 法 将 
Bean 里 面 的 内 容 转 换 为 JSON 内 容 , 使 用 fromJson(String，Class) 方 法 将 JSON 对 象 封装 
出 单个 的 Bean 对 象 。 

toJson() 方 法 主要 有 以 下 几 种 形式 。 


String toJson (JsonElement jsonElement): 用 于 将 JsonElement 对 象 ( 如 
JsonObject,JsonArray 等 ) 转 换 成 JSON 数据 。 

String toJson(Object src): 用 于 将 指定 的 Object 对 象 序列 化 成 相应 的 JSON 数据 。 
String toJson(Object src, Type typeOfSrc) ; 用 于 将 指定 的 Object 对 象 ( 可 以 包括 
泛 型 类 型 ) 序 列 化 成 相应 的 JSON 数据 。 


fromJson() 方 法 主要 有 以 下 几 种 形式 : 


<T> T fromJson(JsonElement json, Class<T> classOfT) 
<T> T fromJson(JsonElement json, Type typeOfT) 
<T> T fromJson(JsonReader reader, Type typeOfT) 
<T> T fromJson(Reader reader, Class<T> classOfT) 
<T> T fromJson(Reader reader, Type typeOfT) 

<T> T fromJson(String json, Class<T> classOfT) 
<T> T fromJson(String json, Type typeOfT) 


这 些 方法 用 于 将 不 同形 式 的 JSON 数据 解析 成 Java 对 象 。 例 如 
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01 public static final String JSON DATA = "..."; 
02 FooBean foo = new Gson().fromJson(JSON DATA, FooBean. class) ; 


(2) GsonBuilder: 用 于 创建 Gson 的 实例 。 与 使 用 new Gson() 不 同 的 是 ,GsonBuilder 
可 进行 与 默认 配置 不 同 的 相关 设置 。 
例如 ,如 果 上 例 中 的 created at 定义 为 Date 类 型 ,有 如 下 Bean: 


01 public class FooBean { 


02 public int id; 

03 public String body; 

04 public float number; 

05 public Date created at; 
06 ] 

解析 时 的 方法 如 下 : 


01 public static final String JSON DATA = "..."; 
02 GsonBuilder gsonBuilder = new GsonBuilder(); 

03 gsonBuilder. setDateFormat(" yyyy ~ MM- dd HH:mm: ss") ; 

04 Gson gson = gsonBuilder.create(); 

05 FooBean foo = gson.fromJson(JSON DATA, FooBean.class); 


(3) TypeToken; 实现 了 获取 泛 型 类 型 的 功能 ,使 用 Type = TypeToken QZW) (). 
gettype() 方 法 将 会 返回 一 个 反射 包 下 的 type 对 象 ,这 就 是 fromJson() 所 需要 的 type 类 型 。 
例如 ,有 JSON 数组 信息 如 下 : 


H 
"id": 100, 
"body": "It is my post1", 
"number": 0.13, 
"created at": "2014 - 05 - 20 19:12:38" 


"id": 101, 

"body": "It is my post2", 

"number": 0.14, 

"created at": "2014 - 05 - 22 19:12:38" 
}] 


下 面 的 代码 实现 了 将 其 解析 成 数组 : 


01 public static final String JSON DATA = "..."; 
02 FooBean[] foos = new Gson().fromJson(JSON DATA, FooBean [].class); 


下 面 的 代码 实现 了 将 其 解析 成 List: 
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01 public static final String JSON DATA = "..."; 
02 Type listType = new TypeToken < ArrayList < FooBean >>(){}.getType() ; 
03 ArrayList <FooBean> foos = new Gson().fromJson(JSON DATA, listType); 





下 面 介绍 使 用 Gson 解析 2. 2. 2 小 节 天 气 预 报 的 示例 。 
根据 天 气 的 JSON 数据 ,首先 建立 WeatherInfo 实体 Bean ,部 分 代码 如 下 : 


01 public class WeatherInfo { 


02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 
16 


private String city; 
private String cityid; 
private String templ; 
private String temp2; 
private String weather; 
private String ptime; 


// 省 略 get 和 set 方法 


@Override 
public String toString() { 
return "WeatherInfo [city=" + city + ", cityid=" + cityid + ", 
+ templ + ", temp2=" + temp2 + ", weather=" + weather 
+ ", ptime=" + ptime + "]"; 


建立 Mode 类 Weather, (RIS F : 


01 public class Weather { 


02 
03 
04 


08 


private WeatherInfo weatherinfo; 
public WeatherInfo getWeatherinfo() { 


return weatherinfo; 


public void setWeatherInfo(WeatherInfo weatherinfo) { 
this.weatherinfo = weatherinfo; 


建立 View 类 Activity ,代码 如 下 : 


01 public class GSONParsingActivity extends Activity { 


02 
03 
04 
05 
06 
07 
08 


private TextView showResult; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R. layout.activity gsonparsing); 


templ =" 
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09 
10 
11 
12 
T3 
14 
15 
16 
E 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
b 


showResult - (TextView) findViewById(R. id. result); 


WeatherAsyncTask task = new WeatherAsyncTask(); 
task. execute( "http://www. weather. com. cn/data/cityinfo/101010100. html"); 


private void handleWeatherResponse(String response) ( 

try f 
Gson gson - new Gson(); 
Weather weather = gson.fromJson(response, Weather. class); 
WeatherInfo info = weather.getWeatherinfo(); 
showWeatherInfo( info); 

] catch (Exception e) ( 

} 


private void showWeatherInfo(WeatherInfo info) { 


showResult. setText(" 城 市 :" + info.getCity() + "Wn" 


+ "气温 :最 高 ”+ info. getTempl() + "最 低 ”+ info.getTemp2() + "Wa" 


+ "今天 天 气 :”+ info. getWeather()); 


class WeatherAsyncTask extends AsyncTask < String, Integer, String» { 


public WeatherAsyncTask() { 


super (); 

l 

@Override 

protected String doInBackground(String... params) { 
String result = ""; 
try { 


result = HttUtil. getRequest(params[0]); 
} catch (InterruptedException e) { 

e. printStackTrace( ) ; 
} catch (ExecutionException e) { 

e. printStackTrace( ) ; 


return result; 


@Override 
protected void onPostExecute(String result) { 
handleWeatherResponse( result) ; 
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58 } 
59 

60 } 

61 

62 } 


2. Json-lib 

Json-lib® 是 一 个 Java 类 库 ,提供 了 如 下 功能 : 

* 将 Java beans, maps,collections,arrays 和 XML 转换 成 JSON 格式 的 数据 。 
。 将 JSON 格式 数据 转换 成 Java beans 对 象 。 

使 用 Json-lib 需要 的 jar 包 包 括 : 

* jakarta commons-lang 2. 5 

* jakarta commons-beanutils 1. 8. 0 

* jakarta commons-collections 3. 2. 1 

* jakarta commons-logging 1. 1. 1 

* ezmorph 1.0.6 

下 面 是 使 用 Json-lib 实现 的 一 个 工具 类 的 核心 代码 : 


01 public class JsonUtil { 


02 

03 / xx 

04 * 设置 日 期 转换 格式 

05 */ 

06 static { 

07 // 注 册 器 

08 MorpherRegistry mr - JSONUtils.getMorpherRegistry(); 

09 

10 // 可 转换 的 日 期 格式 , 即 Json 串 中 可 以 出 现 以 下 格式 的 日 期 与 时 间 
imt DateMorpher dm = new DateMorpher(new String[] ( Util. YYYY MM DD, 
12 Util. YYYY MM DD HH MM ss, Util.HH MM ss, Util. YYYYMMDD, 
13 Util. YYYYMMDDHHMMSS, Util.HHMMss ]); 

14 mr. registerMorpher(dm); 

15 } 

16 

JT /x 

18 * 从 json 串 转 换 成 实体 对 象 

19 * @param jsonObjStr e.g. ('name':'get','dateAttr':'2009 — 11- 12'] 
20 * @param clazz Person. class 

21 * @return 

22 «/ 

23 public static Object getDtoFromJsonObjStr(String jsonObjStr, Class clazz) { 
24 return JSONObject. toBean(JSONObject. fromObject( jsonObjStr), clazz); 
25 } 


© Json-lib 官 网 : http: //json-lib. sourceforge. net/。 
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26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
SI 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 


/ xx 
* 从 json 串 转 换 成 实体 对 象 ,并 且 实 体 集合 属性 中 存 有 另外 的 实体 Bean 
* @param jsonObjStr e.g. ('data':[('name' :'get'), ('nane':'set']]) 
* @param clazz e.g. MyBean.class 
* @param classMap e.g. classMap. put("data", Person.class) 
* @return Object 
«/ 
public static Object getDtoFromJsonObjStr(String jsonObjStr, 
Class clazz, Map classMap) { 
return JSONObject. toBean(JSONObject. fromObject( jsonObjStr), 
clazz, classMap); 


/xx 

* 把 一 个 json 数 组 串 转换 成 普通 数组 

* @param jsonArrStr e.g. ['get',1,true, null] 

* @return Object[ ] 

x/ 

public static Object[] getArrFromJsonArrStr(String jsonArrStr) { 
return JSONArray. fromObject( jsonArrStr).toArray(); 


/ xx 
* 把 一 个 json 数 组 串 转换 成 实体 数组 
# @param jsonArrStr e.g. [{'name':'get'},{'name':'set'}] 
* @param clazz e.g. Person.class 
* @return Object[] 
*/ 
public static Object[] getDtoArrFromJsonArrStr( String jsonArrStr, 
Class clazz) ( 
JSONArray jsonArr = JSONArray. fromObject(jsonArrStr) ; 
Object[] objArr = new Object[jsonArr. size()]; 
for (int i = 0; i< jsonArr. size(); i++) { 


objArr[i] = JSONObject. toBean(jsonArr. getJSONObject(i), clazz); 


i 
return objArr; 


/x** 


* 把 一 个 json 数组 串 转换 成 实体 数组 , 且 数 组 元 素 的 属性 中 含有 另外 的 实例 Bean 


* @param jsonArrStr 

* e.g. [('data':[('nane' :'get') ]) , ('data' :[('nane' :'set']]]] 

* @param clazz e.g. MyBean.class 

* @param classMap e.g. classMap. put("data", Person. class) 

* @return Object[ ] 

*/ 

public static Object[ ] getDtoArrFromJsonArrStr( String jsonArrStr, 
Class clazz, Map classMap) { 
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75) JSONArray array = JSONArray. fromObject(jsonArrStr) ; 

76 Object[ ] obj = new Object[array. size()]; 

TI. for (int i = 0; i< array. size(); i++) ( 

78 JSONObject jsonObject = array.getJSONObject(i); 

79 obj[i] = JSONObject. toBean( jsonObject, clazz, classMap); 
80 } 

81 return obj; 

82 } 

83 

84 / xx 

85 * 把 一 个 json 数 组 串 转换 成 存放 普通 类 型 元 素 的 集合 

86 * @param jsonArrStr e.g. ['get',1,true, null] 

87 * @return List 

88 x/ 

89 public static List getListFromJsonArrStr(String jsonArrStr) { 
90 JSONArray jsonArr = JSONArray. fromObject( jsonArrStr); 
91 List list = new ArrayList(); 

92 for (int i = 0; i< jsonArr. size(); i++) { 

93 list. add( jsonArr. get(i)); 

94 } 

95 return list; 

96 } 

97. 

98 / xx 

99 * 把 一 个 json 数 组 串 转换 成 集合 , 且 集 合 里 存放 的 是 实例 Bean 
100 * @param jsonArrStr e.g. [('name':'get'), ('name':'set']] 
101 * @param clazz 

102 * @return List 

103 x/ 

104 public static List getListFromJsonArrStr(String jsonArrStr, 
105 Class clazz) ( 

106 JSONArray jsonArr = JSONArray.fromObject(jsonArrStr); 
107 List list = new ArrayList(); 

108 for (int i = 0; i<jsonArr.size(); i++) ( 

109 list. add( JSONObject. toBean(jsonArr. getJSONObject(i), clazz)); 
110 } 

aii return list; 

112 } 

113 

114 /xx 

115 * 把 一 个 json 数组 串 转换 成 集合 , 且 集合 里 对 象 的 属性 中 含有 另外 的 实例 Bean 
116 * @param jsonArrStr 

117. * e.g. [{'data':[{'name':'get'}]},{'data':[{'name':'set'}]}] 
118 * @param clazz e.g. MyBean.class 

119 * @param classMap e.g. classMap. put("data", Person. class) 
120 * @return List 

121 x/ 

122 public static List getListFromJsonArrStr(String jsonArrStr, 
123 Class clazz, Map classMap) { 


60 


第 2 章 数据 解析 





124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 


170 
171 


JSONArray jsonArr = JSONArray. fromObject(jsonArrStr) ; 
List list = new ArrayList(); 
for (int i = 0; i< jsonArr. size(); i++) { 
list. add(JSONObject. toBean( jsonArr.getJSONObject(i), 
clazz, classMap)); 
} 


return list; 


/xx 
* 把 json 对 象 串 转换 成 map 对 象 
* (param jsonObjStr e.g. ('name':'get', 'int':1, 'double',1.1, 'null':null} 
* (return Map 
x/ 
public static Map getMapFromJson0bjStr(String jsonObjStr) ( 
JSONObject jsonObject = JSONObject.fromObject(jsonObjStr); 


Map map = new HashMap() ; 

for (Iterator iter - jsonObject.keys(); iter.hasNext();) ( 
String key = (String) iter.next(); 
map, put (key, jsonObject. get(key) ); 

) 

return map; 


/ xx 
* 把 json 对 象 串 转换 成 map 对 象 , A map 对 象 里 存放 的 是 其 他 的 实体 Bean 
* @param jsonObjStr e.g. {'datal':{'name':'get'}, 'data2':{'name':'set'}} 
* @param clazz e.g. Person.class 
* @return Map 
x/ 
public static Map getMapFromJsonObjStr(String jsonObjStr, 
Class clazz) ( 
JSONObject jsonObject = JSONObject.fromObject(jsonObjStr); 


Map map = new HashMap() ; 
for (Iterator iter - jsonObject.keys(); iter.hasNext();) ( 
String key = (String) iter.next(); 
map.put(key, JSONObject. toBean( jsonOb;ject. getJSONObject(key), 
clazz)); 


return map; 


/xx 

* 把 json 对 象 串 转换 成 map WR, H map 对 象 里 存放 的 是 其 他 的 实体 Bean, 还 含有 另外 的 
实体 Bean 

* @param jsonObjStr e.g. {'mybean':{'data':[{'name':'get'}]}} 

* @param clazz e.g. MyBean. class 
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172 * @param classMap e.g. classMap.put("data", Person.class) 
173 * (return Map 

174 x/ 

r5 public static Map getMapFromJsonObjStr(String jsonObjStr, 

176 Class clazz, Map classMap) ( 

177 JSONObject jsonObject = JSONObject.fromObject(jsonObjStr); 
178 

179 Map map = new HashMap() ; 

180 for (Iterator iter - jsonObject.keys(); iter.hasNext();) ( 
181 String key = (String) iter.next(); 

182 map. put(key, JSONObject 

183 . toBean(jsonObject. getJSONObject (key), clazz, classMap) ) ; 
184 } 

185 return map; 

186 } 

187 

188 [x 

189 * 把 实体 Bean Map 对 象 数 组 、 列 表 集 合 转换 成 json ti 

190 * @param obj 

191 * @return 

192 * @throws Exception String 

193 x/ 

194 public static String getJsonStr(Object obj) ( 

195 String jsonStr = null; 

196 // 配 置 json 

197 JsonConfig jsonCfg = new JsonConfig(); 

198 

199 // 注 册 日 期 处 理 器 

200 jsonCfg. registerJsonValueProcessor( java. util. Date. class, 
201 new JsonDateValueProcessor(Util.YYYY MM DD HH MM ss)); 
202 if (obj == null) { 

203 return "{}"; 

204 } 

205 

206 if (obj instanceof Collection || obj instanceof Object[]) { 
207 jsonStr = JSONArray.fromObject(obj, jsonCfg).toString(); 
208 } else { 

209 jsonStr = JSONObject. fromObject(obj, jsonCfg).toString(); 
210 } 

211 

212 return jsonStr; 

213 } 

214 

215 / ** 

216 * 把 json $% H #4 (collection map) ,实体 Bean 转换 成 XML® 


@ XMLSerializer API: http: //json-lib. sourceforge. net/apidocs/net/sf/json/xml/XMLSerializer. html。 具 体 实 
例 请 参考 : http: //jsonclib. sourceforge. net/xref-test /net/sf/json/xml/TestXMLSerializer_writes. html; http: //json-lib. 


sourceforge. net/xref-test/net/sf/json/xml/TestXMLSerializer_writes. html, 
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TR * @param obj 

218 * @return 

219 * @throws Exception String 

220 x4 

221 public static String getXMLFromObj(Object obj) { 

222 XMLSerializer xmlSerial = new XMLSerializer(); 

223 

224 // 配 置 json 

225 JsonConfig jsonCfg = new JsonConfig(); 

226 

227 // 注 册 日 期 处 理 器 

228 jsonCfg. registerJsonValueProcessor( java. util.Date.class, 
229 new JsonDateValueProcessor(Util.YYYY MM DD HH MM ss)); 
230 

231 if ((String.class.isInstance(obj) && 

232 String.valueOf(obj).startsWith("[")) 

233 || obj. getClass(). isArray() 

234 || Collection. class. isInstance(obj)) { 

235 JSONArray jsonArr - JSONArray.fromObject(obj, jsonCfg); 
236 return xmlSerial. write(jsonArr) ; 

237 } else { 

238 JSONObject jsonObj = JSONObject.fromObject(obj, jsonCfg) ; 
239 return xmlSerial. write(json0bj) ; 

240 } 

241 } 

242 

243 / xx 

244 * 从 XML 中 转换 成 json 串 

245 * @param xml 

246 * @return String 

247 x/ 

248 public static String getJsonStrFromXML(String xml) { 

249 XMLSerializer xmlSerial = new XMLSerializer(); 

250 return String. valueOf (xnlSerial.read(xml)); 

251 } 

252 

2531] 


除了 前 面 介绍 的 Gson Json-lib 等 解析 工具 外 ,FastJson?、Jackson® 也 是 常见 的 JSON 
解析 工具 。 


2.3 z] 题 


1. 从 asserts 中 读 取 XML 文件 并 解析 显示 在 用 户 界面 上 。 
2. 编程 实现 从 中 国 天 气 预 报 网 获取 json 天 气 信息 ,然后 解析 并 显示 在 用 户 界面 上 。 


(D  Fastjson 官网 : http://code. alibabatech. com/ wiki/display/FastJjSON/Home-zh. 
Q Jackson 官网 : http: //jackson. codehaus. org. 
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移动 互联 网 应 用 需要 根据 应 用 自身 的 特点 和 服务 方式 选择 不 同 的 联网 策略 ,Android 
平台 为 管理 网 络 的 连接 类 型 和 网 络 状态 提供 了 健全 的 编程 接口 。 


3.1 ConnectivityManager 与 网 络 管理 


Android SDK 为 标准 网 络 bluetooth, NFC、WirFi 等 的 连接 与 管理 提供 了 丰富 的 接口 。 
3.1.1 ConnectivityManager 的 功能 


ConnectivityManager 是 android. net 包 提 供 的 用 于 管理 与 网 络 连接 相关 的 操作 类 , 包 
括 查 询 网 络 连 接 状 态 、 当 网 络 状态 发 生 改变 时 通知 应 用 等 。 

ConnectivityManager 的 主要 任务 包括 : 

。 监听 手机 网 络 的 状态 (包括 GPRS, Wi-Fi, UMTS 等 ) 。 

。 网 络 状态 发 生 改 变 时 发 送 广 播 。 

。 当 一 个 网 络 连接 失败 时 进行 故障 切换 (尝试 连接 到 别 的 网 络 ) 。 

。 为 应 用 程序 查询 网 络 状 态 提 供 API 接口 。 

初始 化 一 个 ConnectivityManager 的 方法 如 下 : 


01 ConnectivityManager connectivity = (ConnectivityManager) context 
02 .getSystemService(Context. CONNECTIVITY SERVICE); 


ConnectivityManager 提供 的 主要 方法 包括 以 下 几 点 。 

* NetworkInfogetActiveNetworkInfoO : 获取 当前 连接 可 用 的 网 络 信息 。 

。 NetworkInfo[ ]|getAllNetworkInfo O : 获取 设备 支持 的 所 有 网 络 类 型 的 连接 状态 
信息 。 

* NetworkInfogetNetworkInfo(int networkType): 获取 特定 网 络 类 型 的 连接 状态 
信息 。 

* intgetNetworkPreference() : 检索 当前 的 首选 网 络 类 型 。 

e boolean isActiveNetworkMetered(): 确定 当前 网 络 是 否 计算 流量 。 

e static booleanisNetworkTypeValid(int networkType): 判断 给 定 的 整数 是 否 表示 
一 种 有 效 的 网 络 类 型 。 

注意 : 要 执行 和 ConnectivityManager 相关 的 网 络 操作 ,需要 在 应 用 程序 的 

AndroidManifest. xml 文件 中 包含 以 下 权限 。 
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"android. permission. INTERNET" /> 
"android. permission. ACCESS_NETWORK_STATE" /> 


<uses - permission android: nam 
«uses - permission android: name 





如 果 需 要 更 改 网 络 状 态 , 还 需要 包含 如 下 权限 : 


«uses - permission android: name = "android.permission.CHANGE NETWORK STATE" /> 





3.1.2. 网 络 连接 判断 


1. 是 否 有 网 络 
当 应 用 程序 试图 连接 到 网 络 时 ,应 该 先 检查 网 络 连 接 是 否 可 用 。 通 常 有 如 下 两 种 做 法 。 
方法 1: 


01 public static boolean isNetworkAvailable(Context context) { 


02 ConnectivityManager connectivity = (ConnectivityManager) context 
03 .getSystemService( Context. CONNECTIVITY SERVICE); 
04 

05 if (connectivity == null) { 

06 Log.w(LOG TAG, "couldn't get connectivity manager"); 

07 } else ( 

08 NetworkInfo[] info = connectivity.getAllNetworkInfo(); 
09 if (info != null) { 

10 for (int i = 0; i< info. length; i++) ( 

m if (info[i].isAvailable()) ( 

12 Log.d(LOG TAG, "network is available"); 

13 return true; 

14 } 

15 } 

16 } 

17 } 

18 

19 Log.d(LOG TAG, "network is not available"); 

20 return false; 

1 

方法 2: 

01 public static boolean isNetworkAvailable(Context context) { 

02 ConnectivityManager connectivity = (ConnectivityManager) context 
03 .getSystemService(Context. CONNECTIVITY SERVICE); 
04 

05 if (connectivity == null) { 

06 Log. w(LOG_TAG, "couldn't get connectivity manager") ; 

07 } else { 

08 NetworkInfo activeNetwork = connectivity.getActiveNetworkInfo(); 
09 } 

10 

11 return activeNetwork. isConnectedOrConnecting( ) ; 

12 3 
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方法 1 中 ,08 行 通过 调用 ConnectivityManager 的 getAll]NetworkInfo( ) 方 法 返回 
NetworkInfo 数组 。NetworkInfo 描述 给 定 类 型 的 网 络 接口 状态 。NetworkInfo 类 包含 了 
对 Wi-Fi 和 MOBILE 两 种 网 络 模式 连接 的 详细 描述 。 

NetworkInfo 提供 了 以 下 重要 的 方法 。 


getStateO ; 获取 代表 着 连接 成 功 与 否 等 状态 的 State 对 象 。 
getDetailedState(): 获取 详细 的 状态 信息 。 

getExtraInfo(): 获取 附加 信息 。 

getReason(): 获取 连接 失败 的 原因 。 

getTypeO ; 获取 网 络 类 型 (一 般 为 Wi-Fi B MOBILE). 
getTypeName(): 获取 网 络 类 型 的 名 称 (一 般 取 值 Wi-Fi 或 MOBILE)。 
isAvailableO ; 判断 该 网 络 是 否 可 用 。 

isConnectedO ; 判断 是 否 已 经 连接 。 
isConnectedOrConnecting(): 判断 是 否 已 经 连接 或 正在 连接 。 
isFailover(): 判断 是 否 连接 失败 。 

isRoaming(): 判断 是 否 漫 游 。 


在 10—15 行 对 NetworkInfo 数组 的 遍历 中 ,通过 调用 isAvailable() 方 法 判断 当前 设备 
有 无 可 用 的 网 络 。 

方法 2 中 ,02 一 03 行 获取 ConnectivityManager 实例 ,然后 通过 08 行 的 getActiveNet- 
workInfo() 方 法 返回 当前 连接 可 用 的 网 络 信息 ,并 调用 isConnectedOrConnecting O 77 18 
断 是 否 已 经 连接 或 正在 连接 可 用 网 络 。 


2. 


网 络 是 否 已 连接 


在 确定 有 可 用 网 络 的 前 提 下 ,还 需要 检查 网 络 是 否 连接 ,方法 如 下 : 


public static boolean checkNetState(Context context) ( 
boolean netstate - false; 
ConnectivityManager connectivity - (ConnectivityManager) context 
.getSystemService(Context. CONNECTIVITY SERVICE); 
if (connectivity != null) { 
NetworkInfo[] info = connectivity.getAllNetworkInfo(); 
if (info != null) { 
for (int i = 0; i< info. length; i++) ( 
if (info[i].getState() == NetworkInfo. State. CONNECTED) { 
netstate = true; 
break; 


i 


return netstate; 
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NetworkInfo 有 两 个 枚 举 类 型 的 成 员 变 量 NetworkInfo. DetailedState 和 NetworkInfo 
. State, 用 于 查看 当前 网 络 的 状态 。 


3.1.3 网 络 接 入 类 型 


1. 


网 络 接 入 类 型 


Android 平台 手机 主要 有 四 种 网 络 连接 类 型 : 无 网 络 ( 这 种 状态 可 能 是 因为 手机 停机 ， 
网 络 没 有 开启 ,信号 不 好 等 原因 )、 使 用 Wi-Fi 上 网 .CMWAP( 中 国 移动 代理 ) 和 CMNET 


上 网 。 
下 面 的 方法 用 于 判断 网 络 连接 的 类 型 ; 
01 public static int getNetworkState(Context context) { 
02 ConnectivityManager connManager = (ConnectivityManager) context 
03 .getSystemService(Context. CONNECTIVITY SERVICE); 
04 
05 //Wi-Fi 
06 State state = connManager. getNetworkInfo(ConnectivityManager. TYPE WIFI) 
07 .getState(); 
08 if (state == State. CONNECTED || state == State. CONNECTING) { 
09 return NETWORN WIFI; 
10 } 
11 
12 //3G 
13 state = connManager. getNetworkInfo(ConnectivityManager. TYPE_MOBILE) 
14 .getState(); 
15 if (state == State.CONNECTED || state == State.CONNECTING) ( 
16 return NETWORN MOBILE; 
17 } 
18 
19 return NETWORN_NONE; 
20 } 


Connectivity Manager 中 的 网 络 接 人 类 型 介绍 如 下 。 


ConnectivityManager. TYPE MOBILE: 移动 数据 连接 。 当 连接 活跃 时 ,所 有 数据 
流量 将 使 用 这 个 默认 网 络 类 型 的 接口 ( 它 有 一 个 默认 路 由 ) ,如 3G、GPRS 等 。 
ConnectivityManager. TYPE_WIFI: Wi-Fi 网 络 。 
ConnectivityManager. TYPE_MOBILE_SUPL: 一 种 基于 标准 、 人 允许 移动 电话 用 户 
与 定位 服务 器 通信 的 协议 。SUPL 的 优势 在 于 独立 于 运营 商 网 络 结构 和 性 价 比 等 。 
此 外 ,与 其 他 类 型 比较 ,基于 SUPL 的 平台 对 现 有 运营 商 的 网 络 影 响 较 小 。 
ConnectivityManager. TYPE MOBILE MMS: 彩信 网络 。 
ConnectivityManager. TYPE WiMAX: 全 球 微波 互联 接 入 。 这 是 一 项 新 兴 的 宽带 
无 线 接 入 技术 ,能 提供 面向 互联 网 的 高 速 连接 ,数据 传输 距离 最 远 可 达 50km。 
WiMAX 还 具有 QoS 保障 、 传 输 速率 高 业务 丰富 多 样 等 优点 。WiMAX 的 技术 起 
点 较 高 ,采用 了 代表 未 来 通信 技术 发 展 方向 的 OFDM/OFDMA, AAS, MIMO 等 先 
进 技术 。 随 着 技术 标准 的 发 展 , WiMAX 逐步 实现 宽带 业务 的 移动 化 ,而 3G 则 实现 
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2. 


移动 业务 的 宽带 化 ,两 种 网 络 的 融合 程度 会 越 来 越 高 。 

ConnectivityManager. TYPE_MOBILE_DUN: 提供 了 通过 Bluetooth 无 线 技术 接 
入 Internet 和 其 他 拨号 服务 的 标准 。 最 常见 的 情况 是 使 用 手机 或 笔记 本 电脑 时 以 
无 线 方式 拨号 接 人 Internet。 

CMWAP 和 CMNET 


有 的 中 国 移动 业务 需要 通过 CM WAP 接 人 点 才能 够 连接 网 络 ,在 做 这 类 应 用 的 时 候 ， 
不 可 避免 地 需要 判断 当前 APNCAPN 指 一 种 网 络 接 人 技术 ,是 通过 手机 上 网 时 必须 配置 的 
一 个 参数 , 它 决定 了 手机 通过 哪 种 接 入 方式 来 访问 网 络 ) 并 切换 APN ,这 样 才能 成 功 连接 到 
网 络 , 从 而 再 进一步 连接 到 服务 器 。 

在 移动 网 络 中 ,目前 国内 主要 有 两 种 连 网 类 型 : CMWAP 和 CMNET。 判断 方法 如 下 : 


01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 


public static String getAPNType(Context context) { 
ConnectivityManager connMgr - (ConnectivityManager) context 
. getSystemService(Context. CONNECTIVITY SERVICE); 
NetworkInfo networkInfo - connMgr.getActiveNetworkInfo(); 


Log.d(LOG TAG, 
"networkInfo.getExtraInfo() is " * networkInfo.getExtraInfo()); 
if (networkInfo. getExtraInfo().toLowerCase().equals("cmnet")) ( 
return "cmnet"; 
) eise ( 
return "cmwap"; 


} 


} 


获取 APN 之 后 ,需要 判断 是 否 是 CMWAP ,如 果 不 是 则 需要 更 改 当 前 APN 为 CMWAP , 
方法 如 下 : 


01 
02 
03 
04 
05 
06 


InetSocketAddress address; 
address = new InetSocketAddress("10.0.0.172", 80); 
java.net.Proxy proxy = new java.net.Proxy( 
java.net.Proxy.Type.HTTP, address); 
HttpURLConnection conn - (HttpURLConnection) 
new URL( httpURL) . openConnection(proxy); 


3. 2G,3G 和 4G 的 判断 

在 开发 Android 应 用 时 ,为 了 给 用 户 节省 流量 ,提高 用 户 的 体验 度 , 还 需要 根据 用 户 当 
前 网 络 情况 来 做 一 些 调整 。 

下 面 的 方法 用 于 判断 网 络 的 模式 ， 


01 
02 
03 
04 


public static enum NetState ( 
NET NO, NET 2G, NET 3G, NET 4G, NET WIFI, NET UNKNOWN 
i; 
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05 public static NetState getNetTypeForWebView(Context context) { 


06 NetState stateCode - NetState. NET NO; 

07 ConnectivityManager cm - (ConnectivityManager) context 
08 .getSystemService(Context. CONNECTIVITY SERVICE); 
09 NetworkInfo ni 7 cm.getActiveNetworkInfo(); 

10 

zr if (ni != null && ni. isConnectedOrConnecting()) { 

12 Switch (ni.getType()) ( 

13 case ConnectivityManager. TYPE WIFI: 

14 stateCode - NetState.NET WIFI; 

15 break; 

16 case ConnectivityManager. TYPE_MOBILE: 

a Switch (ni.getSubtype()) ( 

18 case TelephonyManager.NETWORK TYPE GPRS: // 联 通 2G 
19 case TelephonyManager.NETWORK TYPE CDMA: // 电 信 2G 
20 case TelephonyManager.NETWORK TYPE EDGE: // 移 动 26 
21 case TelephonyManager. NETWORK TYPE 1xRTT: 

22 case TelephonyManager. NETWORK TYPE IDEN: 

23 stateCode = NetState. NET 2G; 

24 break; 

25 case TelephonyManager.NETWORK TYPE EVDO A: //Hifii 3G 
26 case TelephonyManager. NETWORK TYPE UMTS: 

27 case TelephonyManager. NETWORK TYPE EVDO 0: 

28 case TelephonyManager. NETWORK TYPE HSDPA: 

29 case TelephonyManager. NETWORK TYPE HSUPA: 

30 case TelephonyManager. NETWORK TYPE HSPA: 

BI case TelephonyManager. NETWORK TYPE EVDO B: 

32 case TelephonyManager. NETWORK TYPE EHRPD: 

33 case TelephonyManager. NETWORK TYPE HSPAP: 

34 stateCode - NetState. NET 3G; 

a5 break; 

36 case TelephonyManager. NETWORK TYPE LTE: 

I stateCode - NetState. NET 4G; 

38 break; 

39 default: 

40 stateCode - NetState. NET UNKNOWN; 

41 ) 

42 break; 

43 default: 

44 stateCode - NetState.NET UNKNOWN; 

45 } 

46 

47 } 

48 

49 return stateCode; 

ze F} 


17 行 通 过 NetworksInfo 对 象 的 getSubTypeO Al getSubTypeName() 可 以 获取 对 应 的 


网 络 类 型 与 名 字 。 
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18 行 的 TelephonyManager 类 主要 提供 了 一 系列 用 于 访问 与 手机 通信 相关 的 状态 和 信 
息 的 getter 方 法 ,包括 手机 SIM 的 状态 和 信息 .电信 网 络 的 状态 及 手机 用 户 的 信息 等 。 
下 面 列 出 了 常见 的 getter 方法。 


getCallStateO : 返回 电话 的 状态 ,包括 CALL_STATE_IDLE( 无 任何 状态 )、ALL_ 
STATE_OFFHOOK( 接 起 电话 时 ) 和 CALL_STATE_RINGING( 电 话 进 来 时 )。 
getDataStateO ; 获取 数据 连接 状态 ,包括 DATA_CONNECTED( 已 连接 ) .DATA_ 
CONNECTING (正在 连接 )、 DATA _ DISCONNECTED (ji JF) 和 DATA _ 
SUSPENDED( 4) 。 

getDeviceldO ; 返回 当前 移动 终端 的 唯一 标识 ,GSM 网 络 返回 IMEI, CDMA 网 络 
返回 MEID。 

getNetworkOperator() : 返回 MCC 十 MNC 代码 。 

getNetworkOperatorName(): 返回 移动 网 络 运营 商 的 名 字 (CSPN ) 。 
getNetworkTypeO : 获取 网 络 类 型 ,包括 NETWORK_TYPE_CDMA( 网 络 类 型 为 
CDMA), NETWORK_TYPE_GPRS( 网 络 类 型 为 GPRS) 等 。 

getSimSerialNumberO : 返回 SIM 卡 的 序列 号 (IMED 。 


3.1.4 监控 网 络 连接 状态 


在 Android 网 络 应 用 程序 开发 中 ,经常 要 判断 网 络 连 接 是 否 可 用 ,因此 经 常 有 必要 监听 
网 络 状态 的 变化 。Android 的 网 络 状态 监听 可 以 用 BroadcastReceiver 来 接收 网 络 状态 改变 


的 广播 ,具体 实现 步骤 如 下 : 

(D 定义 一 个 BroadcastReceiver ,并重 载 其 中 的 onReceive() 方 法 ,在 其 中 完成 监测 连 网 
状态 的 功能 ,例如 : 

01 private class ConnectionChangeReceiver extends BroadcastReceiver{ 

02 @Override 

03 public void onReceive(Context context, Intent intent) { 

04 ConnectivityManager connectivityManager = (ConnectivityManager) 

05 context. getSystemService( Context. CONNECTIVITY SERVICE ); 

06 NetworkInfo activeNetInfo = 

07 connect ivityManager. getAct iveNetworkInfo() ; 

08 NetworkInfo mobNetInfo = connectivityManager. getNetworkInfo( 

09 ConnectivityManager. TYPE MOBILE ); 

10 if ( activeNetInfo != null) { 

a1 Toast. makeText( context, "Active Network Type : " 

12 + activeNetInfo. getTypeName( ), 

13 Toast.LENGTH SHORT ).show(); 

14 } 

15 if( mobNetInfo != null ) { 

16 Toast.makeText( context, "Mobile Network Type : " 

17. + mobNetInfo. getTypeName(), 

18 Toast.LENGTH SHORT ).show(); 

19 } 

20 } 

zw f} 
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© 只 要 网 络 的 连接 状态 发 生变 化 , ConnectivityManager 就 会 立刻 发 送 广播 
CONNECTIVITY_ACTION。 因 此 ,需要 在 适当 的 地 方 注册 BroadcastReceiver, 例 如 ,在 
Activity 的 onCreate() 生 命 周 期 方法 中 添加 如 下 动态 注册 信息 : 


01 IntentFilter intentFilter = new IntentFilter(); 
02 intentFilter.addAction(ConnectivityManager.CONNECTIVITY ACTION); 
03 registerReceiver(connectionChangeReceiver, intentFilter); 


© 在 适当 的 地 方 取消 注册 BroadcastReceiver, 例 如 ,在 Activity 的 onDestroye() 生 命 
周期 方法 中 添加 如 下 动态 取消 注册 信息 : 


01 if (connectionChangeReceiver!= null) { 
02 unregisterReceiver(connectionChangeReceiver) ; 
03 ] 


说 明 : 通常 网 络 的 改变 会 比较 频繁 ,因此 没有 必要 不 间断 地 注册 监听 网 络 的 改变 。 另 
外 ,通常 用 户 会 在 有 Wi-Fi 的 时 候 进行 下 载 动作 , 若 切换 到 移动 网 络 , 则 通常 会 暂停 当前 的 
下 载 , 当 监听 到 恢复 到 Wi-Fi 的 情况 时 ,又 开始 恢复 下 载 。 


3.2 Wi-Fi 网 络 连接 与 管理 


android. net. wifi 包 提 供 了 对 Wi-Fi 网 络 操作 和 管理 的 类 , 包括 WifiManager, 
ScanResult、WifiConfiguration、WifiInfo, 此 外 还 有 WifiLock, MulticastLock 等 。 

注意 : 要 执行 和 Wi-Fi 相关 的 网 络 操作 ,需要 在 应 用 程序 的 AndroidManifest. xml X: 
件 中 包含 以 下 权限 : 


« uses - permission android: name = "android. permission. ACCESS WIFI STATE" /> 
«uses — permission android: name = "android.permission.CHANGE WIFI STATE" /> 


3.2.1 WifiManager 


WifiManager 提供 Wi-Fi 管理 的 各 种 API, 主 要 包含 Wi-Fi 的 扫描 、 建 立 连接 和 配置 等 。 
获取 WifiManager 实例 的 方法 如 下 : 


01 WifiManager mWifiManager = (WifiManager) context 
02 .getSystemService(Context. WIFI SERVICE); 


WifiManager 提供 了 如 下 的 重要 方法 。 
* addNetwork(WifiConfiguration config): 添加 一 个 config 描述 的 Wi-Fi 网 络 ,默认 
情况 下 ,这 个 Wi-Fi 网 络 是 DISABLE 状态 的 。 
* enableNetwork(int netId, Boolean disableOthers) : 连接 netId 所 指 的 Wi-Fi 网 络 ， 
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并 使 其 他 网 络 都 被 禁用 。 

disableNetwork(int netId) : 让 一 个 网 络 连 接 失 效 。 

removeNetwork(int netId) : 移 除 某 一 个 网 络 及 其 连接 配置 (与 disableNetwork() 方 
法 不 同 ,disableNetwork() 只 是 单纯 地 断 开 连 接 ,保存 的 ssid 和 密码 并 不 清除 ) 。 
calculateSignalLevel(int rssi, int numLevels) : 计算 信号 的 等 级 。 
compareSignalLevel(int rssiA, int rssiB) : 将 连接 A 和 连接 B 做 对 比 。 
createWifiLock(int lockType, String tag): 创建 一 个 Wi-Fi 锁 ,锁定 当前 的 Wi-Fi 
连接 。 

updateNetwork(WifiConfiguration config): 更 新 一 个 网 络 连接 的 信息 。 
setWifiEnabled(): 让 一 个 连接 有 效 。 

isWifiEnabledO ; 判断 一 个 Wi-Fi 连接 是 否 有 效 。 

disconnectO : 断 开 连接 。 

reconnectO ;. 如 果 连 接 准备 好 了 , 则 连通 网 络 。 

getConfiguredNetworks(): 获取 网 络 连 接 的 状态 。 

getConnectionInfo(): 获取 当前 连接 的 信息 。 

getDhcpInfo(): 获取 DHCP 的 信息 。 

getScanResulatsO : 获取 扫描 测试 的 结果 。 

getWifiState(): 获取 一 个 Wi-Fi 接 人 点 是 否 有 效 。 

pingSupplicantO : ping 一 个 连接 ,判断 是 否 能 连通 。 

ressociate(): 即便 连接 没有 准备 好 ,也 要 连通 。 

saveConfigurationO : 保留 一 个 配置 信息 。 

startScan(): 开始 扫描 。 


下 面 列举 几 个 常见 的 应 用 。 
(1) 开启 Wi-Fi 网 络 


01 


public boolean openWifi() ( 
boolean bRet - true; 


if (!mWifiManager. isWifiEnabled()) { 
bRet = mWifiManager. setWif iEnabled(true); 
} 


return bRet; 


(2) XH] Wi-Fi 网 络 


01 
02 
03 
04 
05 


public void closeWifi() { 
if (mWifiManager. isWifiEnabled()) { 
mWifiManager. setWifiEnabled(false); 
) 
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(3) 检查 Wi-Fi 的 状态 


01 public int checkState() { 


02 
03 


return mWifiManager. getWifiState(); 


调用 setWifiEnabled O Ja, 系统 进行 Wi-Fi 模块 的 开启 需要 一 定时 间 , 此 时 通过 


WifiManager. getWifiState() 获 取 的 状态 来 判断 是 否 完成 。 这 些 状 态 包 括 以 下 几 种 。 
.WIFI STATE_DISABLED: Wi-Fi 网 卡 不 可 用 。 

.WIFI STATE DISABLING:; Wi-Fi 网 卡 正在 关闭 。 

.WIFI STATE_ENABLED: Wi-Fi 网 卡 可 用 。 

.WIFI STATE_ENABLING: Wi-Fi 网 卡 正在 打开 。 

.WIFIL STATE_UNKNOWN: 未 知 网 卡 状态 。 


WifiManager 
WifiManager. 
WifiManager 
WifiManager 
WifiManager 


(4) 断 开 指定 的 网 络 


public void disConnectionWifi(int netId) ( 
mWifiManager. disableNetwork(netId) ; 


mWifiManager. disconnect() ; 


此 外 WifiManaer 还 提供 了 一 个 内 部 的 子 类 WifiManagerLock, WifiManagerLock 的 
作用 是 在 普通 状态 下 ,如 果 Wi-Fi 的 状态 处 于 闲置 ,那么 网 络 的 连通 将 会 暂时 中 断 。 但 是 如 
果 把 当前 的 网 络 状态 锁 上 ,那么 Wi-Fi 连通 将 会 保持 在 一 定 状态 ,当然 解除 锁定 之 后 ,就 会 


恢复 常态 。 
示例 代码 如 下 : 
01 WifiLock mWifiLock; 
02 // 锁 定 WifiLock 
03 public void acquireWifiLock() { 
04 mWifiLock. acquire(); 
05 } 
06 
07 // 解 锁 Wi iLock 
08 public void releaseWifiLock() { 
09 // 判 断 是 否 锁定 
10 if (mWifiLock. isHeld()) { 
11 mWifiLock. acquire( ) ; 
12 } 
13 } 
14 
15 // 创 建 一 个 WifiLock 
16 public void createWifiLock() { 
17 mWifiLock = mWifiManager. createWifiLock("test"); 
18 
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3.2.2 ScanResult 


ScanResult 主要 通过 Wi-Fi 硬件 的 扫描 来 获取 一 些 周边 的 Wi-Fi 热点 信息 ,包含 
SSID、Capabilities、frequency、level( 信 和 号 强度 ) 等 。 
SSID: 网 络 的 名 字 。 当 搜索 一 个 网 络 时 ,就 是 靠 这 个 来 区 分 每 个 不 同 的 网 络 接 
人 点 。 
Capabilities: 网 络 接 人 的 性 能 。 这 里 主要 用 来 判断 网 络 的 加 密 方式 (WPA、 
WPE) 等 。 
Frequency: 频率 。 每 一 个 频道 交互 的 MHz 数 。 
Level: 等 级 。 主 要 用 来 判断 网 络 连接 的 优先 数 。 
扫描 网 络 的 一 般 方式 如 下 : 





01 public void startScan() { 


02 mWifiManager. startScan(); 

03 // 得 到 扫描 结果 

04 List <ScanResult > mWifiList = mWifiManager.getScanResults(); 
05 ] 


3.2.3 WifiConfiguration 


WifiConfiguration 主要 描述 Wi-Fi 配置 的 所 有 信息 。 
下 面 的 方法 用 于 连接 一 个 新 的 Wi-Fi 网 络 : 


01 public boolean connect(String SSID, String Password, WifiCipherType Type) { 


02 if (!this. openWifi()) { 

03 return false; 

04 } 

05 

06 while (mWifiManager. getWifiState() == 

07 WifiManager.WIFI STATE ENABLING) { 
08 try { 

09 Thread. currentThread(); 

10 Thread. sleep(100) ; 

11 ) catch (InterruptedException ie) { 

12 } 

13 } 

14 

15 WifiConfiguration wifiConfig = createWifilnfo(SSID, Password, Type); 
16 

17 if (wifiConfig == null) { 

18 return false; 

19 } 

20 

21 WifiConfiguration tempConfig = isExsits(SSID, mWifiManager) ; 
22 
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23 if (tempConfig != null) { 

24 mWifiManager. removeNetwork( tempConf ig. networkId); 

25 } 

26 

27 int netID = mWifiManager. addNetwork(wifiConfig) ; 

28 boolean bRet = mWifiManager.enableNetwork(netID, false); 
29 

30 return bRet; 

af 


因为 开启 Wi-Fi 功能 需要 一 段 时 间 ( 一 般 需 要 1 一 3 秒 ) ,所 以 通过 06 ~13 行 的 等 待 使 
得 Wi-Fi 的 状态 变 成 WIFI STATE ENABLED 的 时 候 才 能 继续 执行 下 面 的 语句 。 
15 行 的 createWifiInfo() 方 法 主要 用 于 配置 一 个 Wi-Fi 网 络 ,代码 如 下 : 


01 public WifiConfiguration createWifiInfo(String SSID, String Password, 


02 WifiCipherType Type) ( 

03 WifiConfiguration config - new WifiConfiguration(); 

04 config.allowedhuthAlgorithns.clear(); 

05 config.allowedGroupCiphers. clear(); 

06 config.allowedKeyManagement. clear(); 

07 config.allowedPairwiseCiphers. clear(); 

08 config.allowedProtocols. clear(); 

09 config.SSID = "\"" + SSID + "\""; 

10 

idi WifiConfiguration tempConfig = isExsits(SSID, mWifiManager) ; 
12 if (tempConfig != null) { 

13 mWifiManager. removeNetwork( tempConf ig. networkId) ; 

14 } 

15 

16 if (Type == WifiCipherType. WIFICIPHER NOPASS) { 

i config.wepKeys[0] = ""; 

18 config. allowedKeyManagement. set( Wif iConfiguration. KeyMgmt. NONE) ; 
19 config. wepTxKeyIndex = 0; 

20 } 

21 if (Type == WifiCipherType. WIFICIPHER WEP) { 

22 config. hiddenSSID = true; 

23 config. wepKeys[0] = "\"" + Password + "\""; 

24 config. allowedAuthAlgorithms 

25 . set(WifiConfiguration. AuthAlgorithm. SHARED); 
26 config. allowedGroupCiphers 

2 . set(WifiConfiguration. GroupCipher.CCMP); 
28 config. allowedGroupCiphers 

29 . set(WifiConfiguration. GroupCipher. TKIP) ; 
30 config. allowedGroupCiphers 

B . set(WifiConfiguration. GroupCipher.WEP40) ; 
32 config. allowedGroupCiphers 

33 . set (WifiConfiguration. GroupCipher. WEP104) ; 
34 config. allowedKeyManagement 
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35 . set(WifiConfiguration. KeyMgmt. NONE) ; 

36 config.wepTxKeyIndex - 0; 

37 } 

38 if (Type == WifiCipherType. WIFICIPHER WPA) { 

39 config. preSharedKey = "\"" + Password + "\""; 

40 config. hiddenSSID = true; 

41 config. allowedAuthAlgorithms 

42 . set(WifiConfiguration. AuthAlgorithm. OPEN); 
43 config. allowedGroupCiphers 

44 . set(WifiConfiguration. GroupCipher. TKIP) ; 

45 config. allowedKeyManagement 

46 . set(WifiConfiguration. KeyMgmt. WPA_PSK) ; 

47 config. allowedPairwiseCiphers 

48 . set(WifiConfiguration. PairwiseCipher. TKIP); 
49 //config. allowedProtocols. set (WifiConf iguration. Protocol. WPA) ; 
50 config. allowedGroupCiphers 

51 . set(WifiConfiguration. GroupCipher. CCMP) ; 

52 config. allowedPairwiseCiphers 

53 . set(WifiConfiguration. PairwiseCipher. CCMP); 
54 config. status = WifiConfiguration. Status. ENABLED; 

55 } 

56 return config; 

BTE) 


WifiConfiguration 包含 6 个 子 类 。 

* WifiConfiguration. AuthAlgorthm: 用 来 判断 加 密 方法 。 

。 WifiConfiguration. GroupCipher; 获取 使 用 GroupCipher 的 方法 来 进行 加 密 。 

* WifiConfiguration. KeyMgmt: 获取 使 用 KeyMgmt 进行 的 加 密 。 

* WifiConfiguration. PairwiseCipher: 获取 使 用 WPA 方式 进行 的 加 密 。 

。 WifiConfiguration. Protocol: 获取 使 用 哪 一 种 协议 进行 加 密 。 

WifiConfiguration. Status; 获取 当前 网 络 的 状态 。 

代码 的 24~35 行 和 41—53 行 就 是 这 6 个子 类 的 设置 方法 。 

54 行 的 WifiConfiguration. Status 提供 了 3 个 字段 表示 Wi-Fi 连接 的 三 种 状态 : 
CURRENT( 值 为 0, 表 示 处 于 连接 状态 )、DISABLED ( 值 为 1, 表示 网 络 不 可 用 ) 和 
ENABLED( 值 为 2, 表 示 网 络 可 用 但 没 连接 ) 。 

connect() 方 法 第 21 行 的 isExsits() 方 法 用 于 判断 当前 的 Wi-Fi 网 络 是 否 存在 ,代码 
如 下 : 


01 private static WifiConfiguration isExsits(String SSID, 


02 WifiManager wifiManager) { 

03 List <WifiConfiguration > existingConfigs = wifiManager 

04 . getConfiguredNetworks( ) ; 

05 

06 for (WifiConfiguration existingConfig : existingConfigs) { 
07 if (existingConfig. SSID. equals("\"" + SSID + "\"")) ( 
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return existingConfig; 


d 


return null; 


3.2.4 Wifilnfo 


描述 已 建立 网 络 连接 后 的 Wi-Fi 信息 ,包含 P、Mac 地 址 .连接 速度 等 信息 。 
下 面 的 代码 是 获取 WifiInfo 实例 的 方法 : 


01 


WifiInfo mWifilnfo = mWifiManager.getConnectionInfo(); 


Wifilnfo 类 的 主要 方法 如 下 。 


getBSSIDO : 获取 接 入 点 的 Mac 地 址 。 

getIpAddress(): 获取 本 机 的 IP 地 址 。 

getLinkSpeedO ; 获取 连接 速度 (不 是 下 载 速度 ) ,单位 为 Mbps。 
getMacAddress(): 获取 Mac 地 址 。 


getNetworkIdO ; 获取 网 络 ID 号 。 每 一 个 设 定好 了 的 网 络 都 有 一 个 独一无二 的 整 


数 型 ID 号 ,用 来 识别 网 络 。 
getRssi(): 返回 收 到 的 信号 强度 ,是 个 负数 (负数 越 大 信号 越 好 ) 。 
getSSIDO : 获取 无 线 信 号 提供 者 的 名 称 (就 是 要 连接 的 网 络 的 名 字 )。 


下 面 的 代码 演示 了 如 何 使 用 这 些 方 法 : 


01 
02 
03 
04 
05 


public String getMacAddress() ( 
return (mWifilnfo == null) ? "NULL" : mWifilnfo. getMacAddress() ; 
j} 


public String getBSSID() { 
return (mWifilnfo == null) ? "NULL" : mWifiInfo.getBSSID(); 
} 


public String getSSID() { 
return (mWifilnfo == null) ? "NULL" : mWifilnfo. getSSID(); 
] 


public int getIpAddress() { 
return (mWifilnfo == null) ? 0 : mWifiInfo.getIpAddress(); 
b 


public int getNetWordId() ( 
return (mWifilnfo == null) ? 0 : mWifiInfo.getNetworkId(); 
) 
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21 public String getWifiInfo() { 
22 return (mWifilnfo == null) ? "NULL" : mWifilnfo. toString(); 
y 


3.2.5 Wi-Fi Direct 


Wi-Fi Direct 的 API 允许 Android 4. 0(API level 14) 以 上 的 应 用 程序 不 通过 网 络 或 热 
点 直接 与 周围 的 设备 进行 连接 。 应 用 程序 可 以 迅速 地 查找 附近 的 设备 并 交换 信息 。 并 且 与 
蓝牙 相 比 , Wi-Fi Direct 的 通信 范围 更 大 。 

1. WifiP2pManager 

android. net. wifi. p2p. WifiP2pManager 类 提供 的 方法 可 用 于 操作 当前 设备 中 的 Wi-Fi 
硬件 ,实现 诸如 探测 .连接 对 等 设备 等 功能 。 

初始 化 一 个 WifiP2pManager 的 方法 如 下 : 


01 WifiP2pManager mManager = (WifiP2pManager) 
02 getSystemService(Context.WIFI P2P SERVICE); 


WifiP2pManager 提供 的 主要 方法 包括 以 下 几 种 。 
initialize(): 通过 Wi-Fi 框架 对 应 用 进行 注册 。 这 个 方法 必须 在 任何 其 他 Wi-Fi 直 
连 方法 使 用 之 前 调用 。 
e connect() : 用 指定 的 配置 来 启动 设备 间 的 对 等 连接 。 
cancelConnectO : 取消 任何 进行 中 的 对 等 设备 间 连 接 请 求 。 
* requestConnectInfoO : 获取 一 个 设备 的 连接 信息 。 
。 createGroupO ; 用 当前 设备 作为 组 管理 员 来 创建 一 个 对 等 组 。 
* removeGroupO : 移 除 当 前 的 点 对 点 连接 组 。 
* requestGroupInfoO : 获取 点 对 点 连接 组 的 信息 。 
* discoverPeersO : 初始 化 对 等 设备 的 发 现 。 
* requestPeersO : 获取 当前 发 现 的 对 等 设备 列表 。 
WifiP2pManager 类 的 方法 需要 传人 一 个 监听 器 ,以 便 Wi-Fi Direct 框架 能 够 通知 
Activity 该 调用 的 状态 。WifiP2pManager 类 的 监听 器 接口 见 表 3-1。 


表 3-1 WifiP2pManager 类 的 监听 器 接口 
监听 器 接口 关联 的 方法 


connect() 





cancelConnect() 
WifiP2pManager. ActionListener createGroup() 
removeGroup() 


discoverPeers() 

















WifiP2pManager. ChannelListener initializeO 
WifiP2pManager. ConnectionInfoListener requestConnectInfoO 
WifiP2pManager. GroupInfoListener requestGroupInfo() 
WifiP2pManager. PeerListListener requestPeers() 


78 





第 3 章 ， 网络 连接 与 管理 


2. 实现 Wi-Fi Direct 连接 

实现 一 个 Wi-Fi Direct 连接 的 基本 步骤 如 下 。 

(1) 初始 化 设置 

在 使 用 Wi-Fi Direct 的 API 之 前 ,必须 确保 应 用 可 以 访问 设备 的 硬件 并 且 设 备 要 支持 
Wi-Fi Direct 的 通信 协议 。 

CD 为 设备 的 Wi-Fi 硬件 获取 权限 并 在 Android 的 清单 文件 中 声明 应 用 正确 使 用 的 最 
低 SDK 版 本 : 


01 
02 
03 
04 
05 
06 


« uses — sdk android:minSdkVersion = "14" /> 

« uses — permission android: name = "android. permission. ACCESS WIFI STATE" /> 

« uses — permission android: name = "android. permission. CHANGE WIFI STATE" /> 
<uses — permission android: name = "android. permission. CHANGE NETWORK STATE" /> 
<uses — permission android: name = "android. permission. INTERNET" /> 

<uses — permission android: name = "android. permission. ACCESS NETWORK STATE" /> 


@ 检查 设备 是 否 支持 WiFi Direct 技术 。 一 种 好 的 解决 办 法 是 当 广 播 接收 器 接收 到 
一 个 WIFIL P2P. STATE CHANGED ACTION 意图 时 ,向 Activity 通知 Wi-Fi Direct 的 


状态 和 相应 的 反应 。 
例如 : 
01 @Override 
02 public void onReceive(Context context, Intent intent) { 
03 535 
04 String action = intent.getAction(); 
05 if (WifiP2pManager.WIFI P2P STATE CHANGED ACTION. equals(action)) { 
06 int state = intent.getIntExtra(WifiP2pManager. EXTRA WIFI STATE, - 1); 
07 if (state -- WifiP2pManager.WIFI P2P STATE ENABLED) ( 
08 //Wifi Direct is enabled 
09 } else ( 
10 //Wi-Fi Direct is not enabled 
11 } 
12 } 
13 
14 } 


(2) 创建 一 个 广播 接收 器 

使 用 Wi-Fi Direct 时 ,通过 监听 广播 意图 来 获知 某 个 特定 事件 的 发 生 。 为 此 ,创建 一 个 
新 的 BroadcastReceiver 类 ,用 来 监听 系统 的 Wi-Fi P2P 状态 的 改变 。 

一 般 构 造 方法 如 下 : 


01 
02 
03 
04 
05 


public WiFiDirectBroadcastReceiver(WifiP2pManager manager, Channel channel, 
WifiDirectActivity activity) { 
super() ; 
this.manager - manager; 
this.channel - channel; 
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06 this.activity = activity; 
o T 


构造 方法 一 般 最 常用 的 就 是 以 WifiP2pManager , WifiP2pManager. Channel 作为 参数 ， 
同时 这 个 广播 接收 器 对 应 的 Activity 也 将 被 注册 进来 。 这 个 广播 接收 器 可 以 向 Activity 发 
送 更 新 或 者 在 需要 的 时 候 可 以 访问 Wi-Fi 硬件 或 通信 通道 。 

在 onReceive() 方 法 中 ,添加 一 个 条 件 来 处 理 各 种 P2P 状态 的 变更 。 代 码 如 下 : 


01 @Override 
02 public void onReceive(Context context, Intent intent) { 


03 String action = intent.getAction(); 
04 if (WifiP2pManager.WIFI P2P STATE CHANGED ACTION. equals(action)) { 
05 // 确 定 Wi-Fi Direct 模式 是 否 已 经 启用 ,并 提醒 Activity 
06 int state = intent. getIntExtra(WifiP2pManager.EXTRA_WIFI_STATE, - 1); 
07 if (state == WifiP2pManager.WIFI_P2P STATE ENABLED) { 
08 activity. setIsWifiP2pEnabled( true) ; 
09 } else { 
10 activity. setIsWifiP2pEnabled( false) ; 
Tn } 
12 } else if (WifiP2pManager. WIFI_P2P_PEERS CHANGED ACTION 
13 . equals(action)) { 
14 // 对 等 点 列表 已 经 改变 
15 ) else if (WifiP2pManager. WIFI P2P CONNECTION CHANGED ACTION 
16 . equals(action)) { 
17 // 连 接 状态 已 经 改变 
18 ) else if (WifiP2pManager.WIFI P2P THIS DEVICE CHANGED ACTION 
19 . equals(action)) { 
20 DeviceListFragment fragment = (DeviceListFragment) 
Zn activity.getFragmentManager() 
22 . findFragmentById(R. id.frag list); 
23 fragment. updateThisDevice( (WifiP2pDevice) 
24 intent. getParcelableExtra( 
25 Wif iP2pManager. EXTRA WIFI P2P DEVICE)); 
26 } 
pal I 
其 中 ,监听 动作 包括 以 下 几 种 。 
* WIFI P2P STATE CHANGED ACTION: 表明 Wi-Fi 对 等 网 络 (P2P) 是 否 已 经 
启用 。 


。 WIFI_P2P_PEERS_CHANGED_ACTION: 表明 可 用 的 对 等 点 的 列表 发 生 了 改变 
(调用 discoverPeers() 方 法 时 )。 
* WIFI_P2P_CONNECTION_CHANGED_ACTION; 表示 Wi-Fi 对 等 网 络 的 连接 状 
态 发 生 了 改变 。 
。 WIFI P2?P_THIS_DEVICE_CHANGED_ACTION: 表示 该 设备 的 配置 信息 发 生 
了 改变 。 
80 
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(3) 创建 一 个 对 等 网 络 管理 器 
在 应 用 程序 的 Activity 中 ,初始 化 一 个 IntentFilter ,代码 如 下 : 


01 private final IntentFilter intentFilter = new IntentFilter(); 

02  intentFilter.addAction(WifiP2pManager. WIFI P2P STATE CHANGED ACTION); 

03 intentFilter.addAction(WifiP2pManager.WIFI P2P PEERS CHANGED ACTION); 

04 intentFilter.addAction(WifiP2pManager.WIFI P2P CONNECTION CHANGED ACTION); 
05 intentFilter.addAction(WifiP2pManager.WIFI P2P THIS DEVICE CHANGED ACTION); 


然后 在 onCreate() 方 法 中 初始 化 WifiP2pManager 的 一 个 实例 ,并 调用 它 的 initialize 
方法 。 这 个 方法 返回 一 个 WifiP2pManager. Channel 对 象 。WifiP2pManager. Channel 用 
于 把 应 用 程序 连接 到 Wi-Fi Direct 框架 中 。 代 码 如 下 : 


01 WifiP2pManager mManager = (WifiP2pManager) 

02 getSystemService(Context.WIFI P2P SERVICE); 

03 Channel mChannel - mManager.initialize(this, getMainLooper(), null); 

04 BroadcastReceiver mReceiver = new WiFiDirectBroadcastReceiver(mManager, 
05 mChannel, this); 


最 后 在 onResume() fl onPause() 方 法 中 注册 和 取消 注册 监听 广播 ,代码 如 下 : 


01 @Override 
02 public void onResume() { 


03 super. onResune() ; 

04 registerReceiver(receiver, intentFilter); 
05. } 

06 


07 @Override 
08 public void onPause() ( 


09 super. onPause( ) ; 
10 unregisterReceiver(receiver); 
11 } 


(4) 发 现 对 等 设备 

调用 discoverPeers() 方 法 去 发 现 可 以 使 用 并 连接 的 对 等 设备 。 这 个 方法 的 调用 是 异步 
的 。 同 时 如 果 创 建 了 一 个 WifiP2pManager. ActionListener 监听 器 ,可 以 通过 onSuccess() 
或 者 onFailure() 方 法 收 到 发 现成 功 或 失败 的 消息 。onSuccess() 方 法 只 能 通知 发 现 的 过 程 
是 否 成 功 而 不 能 提供 任何 关于 发 现 设备 的 信息 ,例如 : 


01 mManager. discoverPeers(channel, new WifiP2pManager. ActionListener() { 


02 @Override 

03 public void onSuccess() { 
04 

05 } 

06 

07 @Override 
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08 public void onFailure(int reasonCode) ( 
09 

10 } 

1 } 

12 ); 


如 果 发 现 过 程 成 功 且 检测 到 了 对 等 设备 ,系统 将 会 广播 出 一 个 WIFI_P2P_PEERS_ 
CHANGED ACTION 意图 ,这 样 就 可 以 利用 广播 监听 器 监听 并 获得 发 现 设备 的 列表 。 当 
应 用 接收 到 WIFI P2P PEERS CHANGED ACTION 意图 时 ,可 以 调用 requestPeers() 方 
法 来 获取 发 现 设备 的 列表 ,代码 如 下 : 


01 private List peers = new ArrayList(); 


Uo 

03 if (WifiP2pManager.WIFI P2P PEERS CHANGED ACTION. equals(action)) { 
04 

05 //request available peers from the wifi p2p manager. This is an 
06 //asynchronous call and the calling activity is notified with a 
07 / /callback on PeerListListener. onPeersAvailable() 

08 if (manager != null) { 

09 manager.requestPeers(channel, peerListListener); 

10 } 

aT } 

12 

13 private PeerListListener peerListListener = new PeerListListener() { 
14 @Override 

15 public void onPeersAvailable(WifiP2pDeviceList peerList) { 

16 peers. clear(); 

17 peers. addAll(peerList. getDeviceList()); 

18 

19 // 如 果 Adapter View 可 以 处 理 该 数据 , 则 把 变更 通知 它 

20 ((WiFiPeerListAdapter) getListAdapter()).notifyDataSetChanged(); 
T if (peers.size() == 0) { 

22 Log. d(WiFiDirectActivity. TAG, "No devices found"); 

23 return; 

24 } 

25 } 

26 } 


(5) 连接 到 设备 

在 获得 发 现 设备 列表 之 后 ,调用 connect() 方 法 去 连接 指定 设备 。 这 个 方法 的 调用 需要 一 
个 包含 待 连接 设备 信息 的 WifiP2pConfig 对 象 。 可 以 通过 WifiP2pManager. ActionListener 接 
收 到 连接 是 否 成 功 的 通知 。 下 面 的 代码 展示 了 连接 过 程 : 

01 @Override 


02 public void connect() ( 


03 // 使 用 在 网 络 上 找到 的 第 一 个 设备 
04 WifiP2pDevice device = peers.get(0); 
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05 

06 WifiP2pConfig config = new WifiP2pConfig(); 

07 config.deviceAddress = device. deviceAddress; 

08 config.wps.setup - WpsInfo.PBC; 

09 

10 mManager. connect(mChannel, config, new ActionListener() { 
PD 

12 @Override 

13 public void onSuccess() { 

14 //WiF iDirectBroadcastReceiver 发 出 通知 

15 

16 

17 @Override 

18 public void onFailure(int reason) { 

19 Toast. makeText(WiFiDirectActivity.this, "Connect failed. Retry." 
20 Toast. LENGTH_SHORT) . show(); 

21 } 

22 H; 

23 } 


在 这 个 代码 片段 中 实现 的 WifiP2pManager. ActionListener 只 会 在 初始 化 成 功 或 失败 
时 通知 用 户 。 要 监听 连接 状态 的 变更 ,需要 实现 WifiP2pManager. ConnectionInfoListener 
接口 。 其 回调 方法 onConnectionInfoAvailable() 将 会 在 连接 状态 改变 时 发 出 通知 。 对 于 多 
个 设备 连接 一 个 设备 的 情况 (比如 ,多 于 3 个 玩家 的 游戏 ,或 者 聊天 软件 ), 其 中 一 个 设备 将 
会 被 指定 为 “ 群 主 ”。 


01 @Override 
02 public void onConnectionInfoAvailable(final WifiP2pInfo info) { 


03 

04 //InetAddress 在 WifiP2pInfo 结构 体 中 

05 InetAddress groupOwnerAddress = 

06 info. groupOwnerAddress. getHostAddress( ) ) ; 

07 

08 // 组 群 协商 后 ,就 可 以 确定 群 主 

09 if (info. groupFormed && info. isGroupOwner) { 

10 // 针 对 群 主 做 某 些 任务 

11 // 一 种 常用 的 做 法 是 ,创建 一 个 服务 器 线程 并 接收 连接 请 求 
12 } else if (info. groupFormed) { 

13 // 其 他 设备 都 作为 客户 端 。 在 这 种 情况 下 ,会 希望 创建 一 个 客户 端 线程 来 连接 群 主 
14 

Ar 


同时 ,修改 BroadcastReceiver 的 onReceive() 方 法 ,其 中 WIFI P2P. CONNECTION - 
CHANGED ACTION 的 部 分 代码 如 下 : 


01 if (WifiP2pManager.WIFI P2P CONNECTION CHANGED ACTION. equals(action)) { 
02 


83 


移动 互联 网 应 用 开发 (基于 Android = 8) 





03 if (mManager == null) { 

04 return; 

05 } 

06 

07 NetworkInfo networkInfo = (NetworkInfo) intent 

08 .getParcelableExtra(WifiP2pManager.EXTRA NETWORK INFO); 
09 

10 if (networkInfo. isConnected()) ( 

TI 

12 // 连 上 了 其 他 的 设备 ,请 求 连接 信息 ,以 找到 群 主 的 IP 

13 mManager. requestConnectionInfo(mChannel, connectionListener); 
14 } 

n s 


其 中 的 requestConnectionInfo() 是 一 个 异步 的 调用 ,所 以 结果 会 传 给 作为 参数 的 连接 
信息 监听 器 。 

(6) 数据 传输 

一 旦 连接 建立 ,就 可 以 通过 Socket 来 进行 数据 的 传输 。 基 本 的 数据 传输 步骤 如 下 : 

(D 创建 一 个 ServerSocket 对 象 。 这 个 服务 端 套 接 字 对 象 等 待 一 个 来 自 指定 地 址 和 端 
口 的 客户 端 连接 且 阻 塞 线程 直到 连接 发 生 , 所 以 把 它 建立 在 一 个 后 台 线 程 里 。 

© 创建 一 个 客户 端 Socket 对 象 。 这 个 客户 端 套 接 字 对 象 使 用 指定 IP 地 址 和 端口 去 连 
接 服务 端 设备 。 

O 从 客户 端 向 服务 端 发 送 数据 。 当 客户 端 成 功 连接 服务 端 设备 后 ,可 以 通过 字 节 流 从 
客户 端 向 服务 端 发 送 数据 。 

@ 服务 端 等 待 客户 端的 连接 (使 用 accept() 方 法 )。 这 个 调用 阻塞 服务 端 线程 直到 客 
户 端 连 接 成 功 。 当 连接 建立 时 ,服务 端 可 以 接受 来 自 客 户 端的 数据 。 执 行 关于 数据 的 任何 
动作 ,如 保存 数据 或 者 展示 给 用 户 。 

下 面 的 例子 ,展示 了 怎样 去 创建 服务 端 和 客户 端的 连接 和 通信 ,并 且 使 用 一 个 客户 端 到 
服务 端的 服务 来 传输 了 一 张 图 像 。 


01 public static class FileServerAsyncTask extends AsyncTask { 


02 

03 private Context context; 

04 private TextView statusText; 

05 

06 public FileServerAsyncTask(Context context, View statusText) { 
07 this.context = context; 

08 this.statusText - (TextView) statusText; 
09 } 

10 

11 @Override 

12 protected String doInBackground(Void... params) { 
13 try { 
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14 
15 
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33 
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39 
40 
41 
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43 
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S7 
58 
59 
60 


/ xx 
* Create a server socket and wait for client connections. This 
* call blocks until a connection is accepted from a client 
*/ 

ServerSocket serverSocket = new ServerSocket(8888); 

Socket client = serverSocket.accept(); 


/ ** 
* If this code is reached, a client has connected and transferred 
* data Save the input stream from the client as a JPEG file 
*/ 
final File f = new File(Environment. getExternalStorageDirectory( ) 
S 
+ context. getPackageName() 
+ "/wifip2pshared- " 
* System.currentTimeMillis() 
+ ". jpg"); 


File dirs = new File(f. getParent()); 
if (!dirs. exists()) 
dirs. mkdirs(); 
f.createNewFile(); 
InputStream inputstream = client. getInputStream( ) ; 
copyFile(inputstream, new FileOutputStream(f)); 
serverSocket. close(); 
return f.getAbsolutePath(); 
} catch (IOException e) { 
Log. e(WiF iDirectActivity. TAG, e.getMessage()); 
return null; 


/ xx 
* Start activity that can handle the JPEG image 
x/ 
@Override 
protected void onPostExecute(String result) { 
if (result != null) { 
statusText. setText("File copied - " + result); 
Intent intent = new Intent(); 
intent. setAction(android. content. Intent. ACTION VIEW); 
intent. setDataAndType(Uri. parse("file://" + result), "image/ * "); 
context. startActivity( intent); 
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在 客户 端 ,使 用 客户 端 套 接 字 连接 服务 端 套 接 字 并 传输 数据 。 核 心 代码 如 下 : 


01 Context context = this. getApplicationContext(); 


02 
03 
04 
05 
06 
07 
08 
09 
10 
ti 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 


String host; 

int port; 

int len; 

Socket socket = new Socket(); 

byte buf[] = new byte[1024]; 

try { 

/xx 
* Create a client socket with the host, 
* port, and timeout information. 
x/ 

Socket. bind(null); 

Socket.connect((new InetSocketAddress(host, port)), 500); 


/ xx 
* Create a byte stream from a JPEG file and pipe it to the output stream 
* of the socket. This data will be retrieved by the server device. 
x/ 
OutputStream outputStream = socket.getOutputStream(); 
ContentResolver cr = context. getContentResolver(); 
InputStream inputStream - null; 
inputStream = cr.openInputStream(Uri.parse("path/to/picture. jpg")); 
while ((len = inputStream.read(buf)) != -1) { 
outputStream. write(buf, 0, len); 
i 
outputStream. close(); 
inputStream. close() ; 
} catch (FileNotFoundException e) { 
//catch logic 
} catch (IOException e) { 
//catch logic 
} 


/x 
* Clean up any open sockets when done 
* transferring or if an exception occurred. 
x/ 
finally ( 
if (socket != null) ( 
if (socket. isConnected()) ( 
try { 
socket. close(); 
} catch (IOException e) { 
//catch logic 
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3. Wi-Fi Direct 服务 搜索 

使 用 Wi-Fi Direct 服务 搜索 ,可 以 在 不 连接 网 络 的 情况 下 ,直接 找到 附近 的 设备 ,也 可 
以 通知 哪些 服务 在 本 地 机 器 上 和 运行。 这些 功能 可 以 实现 在 没有 可 用 的 本 地 网 络 或 热点 时 ， 
进行 应 用 程序 之 间 的 通信 。 

CD 添加 一 个 本 地 服务 

如 果 要 提供 一 个 本 地 服务 ,需要 注册 服务 搜索 ,然后 框架 会 自动 向 对 等 点 的 服务 搜索 请 
求 做 出 回应 。 创 建 一 个 本 地 服务 的 步骤 如 下 : 

® 创建 一 个 WifiP2pServiceInfo 对 象 。 

@ 将 服务 信息 填 入 该 对 象 。 

© 调用 addLocalService() 来 注册 用 于 服务 搜索 的 本 地 服务 。 


例如 : 


01 private void startRegistration() { 


02 
03 
04 
05 


// 创 建 一 个 包含 服务 信息 的 字符 串 映射 

Map record = new HashMap(); 

record.put("listenport", String. valueOf(SERVER PORT)); 
record.put("buddyname", "John Doe" * (int) (Math.random() * 1000)); 
record. put( "available", "visible"); 


// 服 务 信息 。 将 一 个 实例 名 传 给 它 , 服 务 类 型 为 _protoco1l. _transportlayer。 映 射 包含 其 
他 设备 在 连 上 它 时 希望 获取 的 信息 


WifiP2pDnsSdServiceInfo serviceInfo = WifiP2pDnsSdServiceInfo 
.newInstance(" test", " presence. tcp", record); 


// 添 加 本 地 服务 ,用 来 发 送 服务 信息 ,网络 频道 , 以 及 将 会 用 到 的 用 来 指示 请 求 成 败 的 监听 器 


mManager. addLocalService(channel, serviceInfo, new ActionListener() { 
@Override 
public void onSuccess() { 
// 命 令 成 功 
i 


@Override 
public void onFailure(int arg0) { 
// 命 令 失败 。 检 查 P2P_UNSUPPORTED, ERROR 或 者 BUSY 


P2P_UNSUPPORTED 表示 运行 程序 的 设备 不 支持 Wi-Fi Direct; BUSY 表示 系统 太 
忙 ,无 法 处 理 请 求 ; ERROR 表示 内 部 错误 引起 的 操作 失败 。 

(2) 搜索 附近 的 服务 

Android 使 用 回调 方法 来 通知 应 用 程序 有 哪些 可 用 的 服务 ,因此 首先 要 创建 一 个 
WifiP2p Manager. DnsSdTxtRecordListener 来 监听 进来 的 记录 。 这 个 记录 也 可 以 被 其 他 设 





87 





移动 互联 网 应 用 开发 (基于 Android = 8) 


备 广播 。 当 有 某 个 设备 加 入 时 ,将 设备 地 址 和 其 他 需要 的 信息 复制 到 当前 方法 以 外 的 一 个 
数据 结构 中 ,这 样 就 可 以 稍 后 再 对 它 进行 操作 。 下 面 的 例子 假定 记录 包含 一 个 buddyname 
域 , 填 人 的 是 用 户 身份 。 


01 final HashMap< String, String> buddies = new HashMap < String, String»(); 


02 
03 
04 


private void discoverService() { 
DnsSdTxtRecordListener txtListener = new DnsSdTxtRecordListener() { 
@Override 
/x 回调 包含 以 下 选项 。 
* fullDomain: 完整 的 域名 : 例如 "printer._ipp._tcp.local" 
* record: 成 对 记录 有 关键 字 和 值 的 数据 的 TXT 
* device: 运行 通知 服务 的 设备 
«/ 
public void onDnsSdTxtRecordAvailable( 
String fullDomain, Map record, WifiP2pDevice device) { 
Log. d(TAG, "DnsSdTxtRecord available -" + record. toString()); 
buddies. put (device. deviceAddress, record. get("buddyname") ) ; 


(3) 获取 服务 信息 

要 获得 服务 信息 ,需要 创建 一 个 WifiP2pManager. DnsSdServiceResponseListener。 它 
接收 实际 的 描述 和 连接 信息 。 前 面 的 代码 片段 实现 了 一 个 Map 对 象 ,将 设备 地 址 和 其 伙 
伴 名 称 进行 配对 。 服 务 回应 监听 器 使 用 这 个 对 象 来 将 DNS 记录 和 对 应 的 服务 信息 联系 
起 来 。 当 两 个 监听 器 都 实现 了 ,就 用 setDnsSdResponseListeners() 方 法 把 它们 添加 进 
WifiP2pManager 中 。 


例如 : 


01 private void discoverService() { 


02 
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DnsSdServiceResponseListener servListener = new 
DnsSdServiceResponseListener() { 
@Override 
public void onDnsSdServiceAvailable(String instanceName, 
String registrationType, WifiP2pDevice resourceType) { 


// 假 定 有 一 个 设备 加 入 了 ,就 使 用 DnsTxtRecord 中 的 通俗 易 懂 的 信息 更 新 设 
备 名 称 


resourceType.deviceName = buddies 
. containsKey(resourceType. deviceAddress) ? buddies 
. get(resourceType. deviceAddress) : 
resourceType. deviceName; 
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16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 


// 添 加 到 为 显示 Wi-Fi 设 备 而 自 定义 的 适配器 中 
WiFiDirectServicesList fragment = (WiFiDirectServicesList) 
getFragmentManager() 
. findFragmentById(R. id. frag peerlist); 
WiFiDevicesAdapter adapter - ((WiFiDevicesAdapter) 
fragnent. getListAdapter()); 


adapter. add( resourceType) ; 


adapter. notifyDataSetChanged(); 
Log.d(TAG, "onBonjourServiceAvailable " * instanceName); 


h 


mManager. setDnsSdResponseListeners(channel, servListener, txtListener); 


现在 创建 一 个 服务 请 求 ,并 调用 addServiceRequestO 。 这 个 方法 也 使 用 一 个 监听 器 来 


汇报 成 功 或 失败 。 
01 serviceRequest = WifiP2pDnsSdServiceRequest. newInstance( ) ; 
02 mManager. addServiceRequest(channel, serviceRequest, new ActionListener() { 
03 @Override 
04 public void onSuccess() { 
05 // 成 功 
06 } 
07 
08 @Override 
09 public void onFailure(int code) { 
10 // 命 令 失败 
11 } 
12 


最 后 ,调用 discoverServices() 方 法 ,例如 : 


01 mManager.discoverServices(channel, new ActionListener() ( 


02 
03 
04 
05 
06 
07 
08 
09 
10 
oky 
12 


@Override 
public void onSuccess() { 
// 成 功 


@Override 

public void onFailure(int code) { 
// 命 令 失败 。 检 查 P2P_UNSUPPORTED , ERROR 或 者 BUSY 
if (code == WifiP2pManager.P2P UNSUPPORTED) { 
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13 Log.d(TAG, "P2P isn't supported on this device."); 
14 else if(...) 


16 } 
17 ); 


在 异步 调用 中 ,包含 一 个 WifiP2pManager. ActionListener 参数 , 它 提 供 了 指明 成 功 或 
失败 的 回调 方法 。 如 需 诊 断 问题 ,将 调试 代码 写 在 onFailure() 里 面 。 


3.3 网络 服务 优化 


本 节 给 出 一 些 关 于 网 络 连接 和 数据 传输 的 优化 建议 及 措施 。 
3.3.1 网 络 连接 的 优化 


网 络 连接 往往 是 耗 电 量 比较 大 的 ,有 效 的 网 络 连接 对 应 用 App 的 性 能 有 重要 的 影响 。 
下 面 是 一 些 对 网 络 连 接 的 优化 建议 : 

CD 在 需要 网 络 连 接 的 程序 中 ,首先 检查 网 络 连 接 是 否 正常 。 如 果 没 有 网 络 连 接 ,那么 
就 不 需要 执行 相应 的 程序 。 

(2) 应 用 程序 没有 必要 不 间断 地 注册 监听 网 络 的 改变 ,可 以 在 执行 一 个 单元 操作 时 监 
听 网 络 的 状态 。 例 如 ,在 执行 一 个 Wi-Fi 模式 下 的 下 载 动作 时 , 若 Wi-Fi 网 络 切 换 到 移动 网 
络 , 则 通常 会 暂停 当前 下 载 , 直 到 执行 另 一 个 任务 时 ,监听 到 恢复 到 Wi-Fi 时 ,再 开始 恢复 
下 载 。 

(3) Wi-Fi 比 蜂窝 数据 更 省 电 ,包括 2GCGPRS) .3G。 尽 量 在 Wi-Fi 下 传输 数据 (通过 
提前 加 载 数据 ,可 以 减少 下 载 数据 所 需要 的 无 线 连接 数 )。 而 在 非 Wi-Fi 下 ,尽量 减少 网 络 
访问 。 虽 然 Wi-Fi 接 人 方式 已 经 占 到 移动 互联 网 用 户 的 50 26 ,但 是 有 些 手 机 设置 为 待机 时 
关闭 Wi-Fi 连接 ,即便 有 Wi-Fi 信号 ,也 只 能 切换 到 蜂窝 数据 。 

(4) 通常 来 说 ,使 用 已 经 存在 的 网 络 连 接 会 比重 新 初始 化 一 个 新 的 网 络 连 接 更 有 效率 。 
重复 使 用 连接 还 能 使 网 络 对 于 拥塞 和 相关 的 网 络 数据 问题 的 响应 更 加 智能 。 例 如 ,应 该 将 
请 求 捆绑 到 一 个 GET 当中 ,而 不 是 创建 多 个 连接 同时 下 载 数据 ,或 多 个 连接 连续 地 发 送 
GET 请 求 。 


3.3.2 数据 传输 的 优化 


在 2009 年 Google IO 大 会 上 ,Jeffrey Sharkey 的 演讲 (Coding for Life — Battery Life, 
That Is) 中 就 探讨 了 Android 应 用 耗 电 的 三 个 方面 : 大 数据 量 的 传输 不 停 地 在 网 络 间 切换 
和 解析 大 量 的 文本 数据 。 

下 面 是 一 些 对 网 络 传输 的 优化 建议 : 

(1) 使 用 效率 高 的 数据 格式 和 解析 方法 ,推荐 使 用 JSON 和 Protobuf 。 

(2) 在 进行 大 数据 量 下 载 时 ,尽量 使 用 GZIP 方式 。 

(3) 减少 下 载 的 最 基本 方法 就 是 只 下 载 所 需 的 。 在 数据 方面 通过 实现 REST APIs, 
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可 以 指定 查询 条 件 来 限制 返回 的 数据 。 

(4) 使 用 本 地 缓存 文件 ,避免 下 载重 复数 据 。 通 常 缓存 静态 资源 ,包括 按 需 下 载 的 合理 
资源 ,并 将 这 些 资源 单独 存储 ,这 样 就 可 以 定期 清理 缓存 以 保证 缓存 的 大 小 。 

(5) 每 次 数据 传输 的 时 候 尽 可 能 地 保持 当前 的 连接 模式 不 改变 ,更 不 要 频繁 地 切换 
模式 。 

(6) 使 用 预 取 模式 下 载 大 数据 。 预 取 数据 是 一 种 减少 独立 数据 传输 会 话 数 量 的 有 效 方 
法 。 预 取 技术 允许 通过 一 次 连接 ,最 大 限度 地 下 载 到 给 定时 间 内 单 次 操作 所 需 的 所 有 数据 。 
通过 预先 加 载 传输 ,可 以 减少 下 载 数 据 所 需 的 电量 损耗 ,而 且 改善 了 延迟 ,降低 了 带宽 占用 ， 
减少 了 下 载 次 数 。 

下 面 的 方法 实现 了 根据 不 同 的 网 络 类 型 来 设置 不 同 的 预 取 数据 量 : 


01 ConnectivityManager cm = (ConnectivityManager) getSystemService( 


02 Context.CONNECTIVITY SERVICE); 

03 

04 TelephonyManager tm = (TelephonyManager) getSystemService( 
05 Context. TELEPHONY SERVICE); 

06 

07 NetworkInfo activeNetwork = cm. getActiveNetworkInfo( ) ; 
08 

09 int PrefetchCacheSize = DEFAULT PREFETCH CACHE; 

10 

11 switch (activeNetwork.getType()) { 

12 case (Connect ivityManager. TYPE _WIFI) : 

13 PrefetchCacheSize = MAX_PREFETCH_CACHE; 

14 break; 

15 case (ConnectivityManager. TYPE MOBILE): { 

16 switch (tm. getNetworkType()) { 

17 case (TelephonyManager. NETWORK TYPE LTE | 

18 TelephonyManager. NETWORK TYPE HSPAP).: 
19 PrefetchCacheSize * - 4; 

20 break; 

21 case (TelephonyManager. NETWORK_TYPE_EDGE | 
PE TelephonyManager. NETWORK TYPE GPRS): 
23 PrefetchCacheSize /= 2; 

24 break; 

25 default: break; 

26 } 

27 break; 

28 } 

29 default: break; 

30 } 


3.3.3 在 独立 线程 中 执行 网 络 连接 


网 络 操作 涉及 不 可 预知 的 延迟 ,为 了 防止 不 良 的 用 户 体验 ,通常 的 做 法 是 从 UI 中 独立 
出 线程 去 执行 网 络 连接 操作 。AsyncTask 类 提供 了 最 简单 地 从 UI 线程 中 独立 出 一 个 新 任 
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务 的 方式 。 
AsyncTask 是 抽象 类 ,在 AsyncTask 中 定义 了 3 种 泛 型 类 型 : Params、Progress 和 
Result。 

* Params 对 应 doInBackground(Params...) 方 法 的 参数 类 型 。 而 new AsyncTask(). 
execute(Params... params) 传 进来 的 就 是 Params 数据 ,可 以 使 用 execute(data) K 
传送 一 个 数据 ,或 者 使 用 execute(datal, ，data2 ，data3) 传 送 多 个 数据 。 

* Progress 对 应 onProgressUpdate(Progress...) 的 参数 类 型 ,显示 后 台 任 务 执行 的 百 
分 比 。 

。 Result 对 应 onPostExecute(Result) 的 参数 类 型 ,后 台 执 行 任务 最 终 返 回 的 结果 , 例 
如 String。 

当 以 上 的 参数 类 型 都 不 需要 指明 时 , 则 使 用 Void, 注 意 不 是 void。 

AsyncTask 执行 的 每 一 步 都 对 应 一 个 回调 方法 ,这 些 方法 不 应 该 由 应 用 程序 调用 , 开 
发 者 需要 做 的 就 是 实现 这 些 方 法 。 首 先 子 类 化 AsyncTask, 然 后 实现 AsyncTask 中 定义 的 
下 面 一 个 或 几 个 方法 。 

。 onPreExecuteO ; 执行 预 处 理 , 它 运行 于 UI 线程 ,可 以 为 后 台 任务 做 一 些 准备 工 
作 , 例 如 绘制 一 个 进度 条 控件 。 

* doInBackground(Params...) : 在 onPreExecute() 方 法 执行 后 马上 自动 执行 ,后 台 进 
程 执 行 的 具体 计算 在 这 里 实现 , 是 AsyncTask 的 关键 , 此 方法 必须 重 载 。 
doInBackground() 的 返回 值 会 传 给 onPostExecute()。 在 doInBackground() 内 的 
任何 时 刻 ,都 可 以 调用 publishProgress() 来 执行 UI 线程 中 的 onProgressUpdate() 
方法 以 更 新 实时 的 任务 进度 。 
注意 : doInBackground(Params...) 中 不 能 直接 操作 UI, 

* onProgressUpdate ( Progress...): 运行 于 UI 线程 。 如 果 在 doInBackground 

(Params...) 中 使 用 了 publishProgress(Progress...) ,就 会 触发 这 个 方法 。 在 这 里 可 
以 对 进度 条 控件 根据 进度 值 做 出 具体 的 响应 。 
* onPostExecute(Result); 运行 于 UI 线程 ,相当 于 Handler 处 理 UI 的 方式 ,在 这 里 
面 可 以 使 用 在 doInBackground 中 得 到 的 结果 处 理 UI 操作。 如 果 Result X null 表 
明 后 台 任 务 没有 完成 (被 取消 或 者 出 现 异常 )。 
可 以 看 出 ,AsyncTask 的 特点 是 在 主线 程 之 外 运行 任务 ,而 回调 方法 是 在 主线 程 中 执 
行 ,这 就 有 效 地 避免 了 使 用 Handler 带 来 的 麻烦 。 
为 了 正确 地 使 用 AsyncTask 类 ,必须 遵守 以 下 几 条 准则 : 
(D AsyncTask 的 实例 必须 在 UI 线程 中 创建 。 
© execute() 方 法 必须 在 UI 线程 中 调用 。 
© 不 要 手动 调用 onPreExecute()、onPostExecute(Result)、doInBackground(Params...) 和 
onProgressUpdate(Progress...) 这 几 个 方法 。 
@ AsyncTask 实例 只 能 被 执行 一 次 ,否则 多 次 调用 时 将 会 出 现 异 常 。 
© 可 以 在 任何 时 刻 、 任 何 线程 内 取消 任务 。 
下 面 的 代码 片段 演示 了 使 用 AsyncTask 异步 下 载 网 页 内 容 的 方法 。 
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public class AsyncTaskActivity extends Activity { 
private static final String DEBUG TAG - "AsyncTask"; 
private EditText urlText; 
private TextView textView; 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState) ; 
setContentView(R. layout. main) ; 
urlText = (EditText) findViewById(R. id. myUrl); 
textView = (TextView) findViewById(R. id. myText) ; 


// 当 用 户 单 击 按钮 则 会 调用 AsyncTask 
public void myClickHandler(View view) ( 
String stringUrl = urlText.getText(). toString(); 
ConnectivityManager connMgr - (ConnectivityManager) 
getSystemService(Context. CONNECTIVITY SERVICE); 
NetworkInfo networkInfo = connMgr.getActiveNetworkInfo(); 
if (networkInfo != null && networkInfo. isConnected()) { 
new DownloadWebpageText(). execute(stringUrl); 
} else ( 
textView. setText("No network connection available. "); 


private class DownloadWebpageText 
extends AsyncTask < String, Integer, String> { 
@Override 
protected String doInBackground(String... urls) { 


// 参 数 来 自 execute(), 调 用 params[0] 得 到 URL 
try { 
return downloadUrl(urls[0]); 
} catch (IOException e) ( 
return "无 法 获取 网 页 ,URL A] 8E JG 2X ! Unable to retrieve web page. " 
* "URL may be invalid."; 


} 

//onPostExecute 显示 AsyncTask 结果 

@Override 

protected void onPostExecute(String result) { 
textView. setText (result) ; 
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这 段 代码 中 ,myClickHandler() 方 法 执行 了 new DownloadWebpageTask(). execute 
(CstringUrl) DownloadWebpageTask 类 是 AsyncTask 的 子 类 ,DownloadWebpageTask 实 
HT AsyncTask 的 方法 : doInbackground() 会 执行 downloadUrl() 方 法 ,downlaodUrl() 方 
法 将 网 页 的 URL 地 址 作为 参数 ,并 获取 和 处 理 网 页 的 内 容 , 当 它 处 理 完 这 些 操作 ,将 会 返 
回 一 个 结果 字符 串 。onPostExecute() 接 受 返 回 字符 串 并 显示 在 UI. 上。 


3.4 =] 题 


l. 编程 实现 以 列表 的 形式 列 出 所 有 可 用 的 无 线 网 络 。 
2. 编程 实现 从 网 络 异步 下 载 一 幅 图 像 并 显示 。 
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$84 X Socket 编程 


Socket( 套 接 字 ) 是 通信 端点 的 抽象 。Socket 提供 了 用 于 不 同 设备 (通过 网 络 相连 ) 上 运 
行 的 进程 相互 通信 的 接口 ,通过 该 接口 可 以 在 同一 台 设备 上 也 可 以 在 不 同 的 设备 上 使 用 该 
接口 和 其 他 进程 通信 。 


4.1 网 络 编程 基础 


本 节 主要 介绍 一 些 网 络 编程 的 基础 知识 。 
4.1.1 TCP/IP 与 网 络 通信 


TCP/IP(Transport Control Protocol/Internet Protocol, 传 输 控制 协议 /Internet 协议 ) 
起 源 于 20 世纪 60 年 代 末 美国 政府 资助 的 一 个 分 组 交换 网 络 研究 项 目 , 它 是 一 个 真正 的 开 
放 协 议 。 
TCP/IP 通信 协议 采用 了 四 层 的 层级 模型 结构 ,每 一 层 都 调用 它 的 下 一 层 所 提供 的 网 
络 任务 来 完成 自己 的 需求 。TCP/IP 的 每 一 层 都 是 由 一 系列 协议 来 定义 的 。 这 4 层 分 别 
如 下 。 
* 应 用 层 (Application) ; 应 用 层 是 个 很 广泛 的 概念 ,有 一 些 基本 相同 的 系统 级 TCP/IP 
应 用 以 及 应 用 协议 ,也 有 许多 的 企业 商业 应 用 和 互联 网 应 用 。 
* 传输 层 (Transport) : 传输 层 包 括 UDP 和 TCP. UDP 几乎 不 对 报 文 进行 检查 ,而 
TCP 提供 传输 保证 。 
网 络 层 (Network) : 网 络 层 协议 由 一 系列 协议 组 成 ,包括 ICMP,IGMP,RIP,OSPF, 
IP(v4 ,v6) 等 。 
。 链 路 层 (Link) : 又 称 为 物理 数据 网 络 接口 层 , 负 责 报 文 传输 。 
在 现 有 的 网 络 中 ,网 络 通信 的 方式 主要 有 两 种 : TCP 方式 和 UDP (User Datagram 
Protocol, 用 户 数据 报 协议 ) 方 式 。 
。 TCP 方式 : 传输 控制 协议 提供 的 是 面向 连接 、 可 靠 的 字 节 流 服务 。 当 客户 和 服务 器 
彼此 交换 数据 前 ,必须 先 在 双方 之 间 建 立 一 个 TCP 连接 ,之 后 才能 传输 数据 。TCP 
提供 超时 重 发 .丢弃 重复 数据 .检验 数据 ,流量 控制 等 功能 ,保证 数据 能 从 一 端 传 到 
另 一 端 。 
每 个 数据 报 的 传输 过 程 是 : 先 建立 链 路 ,传输 数据 ,然后 清除 链 路 。 数 据 报 不 
包含 目的 地 址 。 收 端 和 发 端 不 但 顺序 一 致 ,而 且 内 容 相 同 。 它 的 可 靠 性 高 。 
。 UDP Jr X: 用 户 数据 报 协议 是 面向 无 连接 的 ,每 个 数据 报 都 有 完整 的 源 、 目 的 地 址 
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及 分 组 编号 ,各 自在 网 络 中 独立 传输 ,传输 中 不 管 其 顺序 ,数据 到 达 收 端 后 再 进行 排 
序 组 装 , 遇 有 丢失 ,差错 和 失 序 等 情况 ,通过 请 求 重 发 来 解决 。 它 的 效率 比较 高 。 
UDP 是 一 个 简单 的 面向 数据 报 的 传输 层 协议 。UDP 不 提供 可 靠 性 , 它 只 是 把 
应 用 程序 传 给 IP. 层 的 数据 报 发 送出 去 ,但 是 并 不 能 保证 它们 能 到 达 目 的 地 。 由 于 
UDP 在 传输 数据 报 前 不 用 在 客户 和 服务 器 之 间 建 立 一 个 连接 , 且 没 有 超时 重 发 等 
机 制 ,故而 传输 速度 很 快 。 
因此 ,重要 的 数据 一 般 使 用 TCP 方式 进行 传输 ,而 大 量 的 非 核心 数据 则 都 通过 UDP 7; 
式 进 行 传递 ,在 一 些 程序 中 甚至 这 两 种 方式 结合 使 用 进行 数据 的 传递 。 


4.1.2. C/S 模式 与 B/S 模式 


1. 客户 /服务 器 模式 

在 TCP/IP 网 络 应 用 中 ,通信 的 两 个 进程 间 相互 作用 的 客户 /服务 器 (Client/Server,C/S) 
模式 的 工作 方式 是 : 客户 向 服务 器 发 出 服务 请 求 ,服务器 接收 到 请 求 后 ,提供 相应 的 服务 。 
客户 /服务 器 模式 的 建立 基于 以 下 两 点 。 

CD 建立 网 络 的 起 因 是 网 络 中 软 硬 件 资源 、 运 算 能 力 和 信息 不 均等 ,需要 共享 ,从 而 造 
就 拥有 众多 资源 的 主机 提供 服务 ,资源 较 少 的 客户 请 求 服务 这 一 非 对 等 状况 。 

(2) 网 间 进 程 通信 完全 是 异步 的 ,相互 通信 的 进程 间 既 不 存在 父子 关系 ,又 不 共享 内 存 
缓冲 区 ,因此 需要 一 种 机 制 为 希望 通信 的 进程 间 建 立 联系 ,为 二 者 的 数据 交换 提供 同步 ,这 
就 是 基于 客户 /服务 器 模式 的 TCP/IP. 

在 服务 器 端 ,服务 器 方 要 先 启动 ,并 根据 请 求 提供 以 下 的 相应 服务 : 

(1) 打开 一 通信 通道 并 告知 本 地 主机 , 它 愿 意 在 某 一 公认 地 址 上 的 某 个 端口 (如 FTP 
的 端口 可 能 为 21) 接 收 客户 请 求 。 

D 等 待 客户 请 求 到 达 该 端口 。 

(3) 接收 到 客户 端的 服务 请 求 时 ,处 理 该 请 求 并 发 送 应 答 信号 。 接 收 到 并 发 服务 请 求 ， 
要 激活 一 个 新 进程 来 处 理 这 个 客户 请 求 。 新 进程 处 理 此 客户 请 求 ,并 不 需要 对 其 他 请 求 做 
出 应 答 。 服 务 完成 后 ,关闭 此 新 进程 与 客户 的 通信 和 链 路 并 终止 。 

CD 返回 第 (2) 步 ,等 待 男 一 客户 请 求 。 

(5) 关闭 服务 器 。 

在 客户 端 ,其 请 求 过 程 为 : 

CD 打开 一 个 通信 通道 ,并 连接 到 服务 器 所 在 主机 的 特定 端口 。 

(2) 向 服务 器 发 服务 请 求 报 文 ,等 待 并 接收 应 答 。 

(3) 继续 提出 请 求 。 

(4) 请 求 结束 后 关闭 通信 通道 并 终止 。 

从 上 面 所 描述 过 程 可 知 : 客户 与 服务 器 进程 的 作用 是 非 对 称 的 ,因此 代码 不 同 ; 服务 
器 进程 一 般 是 先 启动 的 。 只 要 系统 运行 ,该 服务 进程 一 直 存在 ,直到 正常 或 强迫 终止 。 

2. 浏览 器 /服务 器 模式 

浏览 器 /服务 器 (Browser/Server,B/S) 模 式 是 实现 基于 Internet 即时 通信 的 主要 工作 
模式 。 

在 B/S 模式 中 ,客户 端 运行 浏览 器 软件 。 浏览 器 以 超 文 本 形式 向 Web 服务 器 提出 访 
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问 数据 请 求 , 请 求 的 方式 分 为 POST 方式 和 GET 方式 。 
* 对 于 GET 请 求 ,浏览 器 其 实 是 一 个 URL 请 求 ,变量 名 和 内 容 都 包含 在 URL 中 JÉ 
stun http://www. url. com/index. jsp? id 一 123 。 
* 对 于 POST 请 求 ,浏览 器 将 生成 一 个 数据 报 , 用 来 将 变量 名 和 它们 的 内 容 捆 绑 在 一 
起 ,并 发 送 到 服务 器 。 
Web 服务 器 接受 客户 端 请 求 后 ,如 果 是 对 静态 页 面 的 请 求 ,就 将 静态 页 面 发 送 给 客户 
端 。 如 果 请 求 的 内 容 需 动态 处 理 , 请 求 将 转交 给 动态 处 理 程序 ,如 CGI, ASP. JSP 等 ,相应 
程序 进行 组 件 访问 及 数据 库 访问 ,将 数据 处 理 结果 交 给 Web 服务 器 。Web 服务 器 响应 来 
自 浏 览 器 的 请 求 , 响 应 一 般 由 状态 行 、 某 些 响 应 头 , 一 个 空 行 和 文档 组 成 。 客 户 端 浏览 器 对 
服务 器 的 响应 进行 解析 ,以 友好 的 Web 页 面 形 式 显 示 出 来 。 


4.1.3 ”网络 相关 包 


Android SDK 中 包含 了 一 些 与 网 络 有 关 的 包 , 如 表 4-1 所 示 。 
表 4-1 Android SDK 网 络 包 


包 iti 述 

提供 与 联网 有 关 的 类 ,包括 流 和 数据 报 (datagram) sockets, Internet 协议 和 常见 
HTTP 处 理 。 该 包 是 一 个 多 功能 网 络 资源 

虽然 没有 提供 显 式 的 联网 功能 ,但 是 该 包 中 的 类 由 其 他 Java 包 中 提供 的 socket 
和 连接 使 用 。 它 们 还 用 于 与 本 地 文件 (在 与 网 络 进行 交互 时 会 经 常 出 现 ) 的 交互 
包含 表示 特定 数据 类 型 的 缓冲 区 的 类 。 适 合 于 两 个 基于 Java 语言 的 端点 之 间 
的 通信 

包含 许多 为 HTTP 通信 提供 精确 控制 和 功能 的 包 。 可 以 将 Apache 视 为 流行 的 
开源 Web 服务 器 

除 核心 java. net. * 类 以 外 ,包含 额外 的 网 络 访问 socket。 该 包 包括 URI 类 ,后 
者 频繁 用 于 Android 应 用 程序 开发 ,而 不 仅仅 是 传统 的 联网 方面 

android. net. http 包含 处 理 SSL 证 书 的 类 

android. net. wifi 包含 在 Android 平 台 上 管理 有 关 Wi-Fi(802. 11 无 线 Ethernet) 所 有 方面 的 类 
android. net. sip 包含 Andriod 平 台 上 管理 有 关 SIP 协议 ,如 建立 和 回应 Voip 的 类 





java. net 





java. io 





java. nio 





org. apache. * 





android, net 




















android. 包含 用 于 管理 和 发 送 SMS 消息 的 类 。 一 段 时 间 后 ,可 能 会 引入 额外 的 包 来 为 非 
telephony. gsm GSM 网 络 提供 类 似 的 功能 ,比如 CDMA 或 android. telephony. cdma 等 网 络 
android. nfc 包含 所 有 用 来 管理 近 场 通信 相关 的 功能 类 


其 中 的 java. net 包 是 标准 的 Java 接口 ,提供 与 联网 有 关 的 类 ,包括 流 、 数 据 报 套 接 字 、 
Internet 协议 .常见 Http 处 理 等 。 该 包 是 一 个 多 功能 网 络 资源 。 

java. net 包 可 以 大 致 分 为 两 个 部 分 。 

1. 低级 API 

低级 API 主要 用 于 处 理 以 下 抽象 。 

CD 地 址 

地 址 也 就 是 网 络 标识 符 , 如 IP 地 址 。InetAddress 类 是 表示 IPCInternet 协议 ) 地 址 的 
抽象 。 它 拥有 两 个 子 类 : 

。 用 于 IPv4 地 址 的 Inet4Address。 
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。 用 于 IPv6 地 址 的 Inet6Address。 

但 是 ,在 大 多 数 情况 下 ,不 必 直 接 处 理子 类 ,因为 InetAddress 抽象 应 该 覆盖 大 多 数 必 
需 的 功能 。 

说 明 : 并 非 所 有 系统 都 支持 IPv6 协议 ,而 当 Java 网 络 连接 堆栈 尝试 检测 它 并 在 可 用 时 
透明 地 使 用 它 时 ,还 可 以 利用 系统 属性 禁用 它 。 在 IPv6 不 可 用 或 被 显 式 禁用 的 情况 下 ， 
Inet6Address 对 大 多 数 网 络 连接 操作 都 不 再 是 有 效 参 数 。 虽 然 可 以 保证 在 查找 主机 名 时 
java. net. InetAddress. getByName 之 类 的 方法 不 返回 Inet6Address, 但 仍然 可 能 通过 传递 
字面 值 来 创建 此 类 对 象 。 在 此 情况 下 ,大 多 数 方法 在 使 用 Inet6Address 调用 时 都 将 抛 出 
异常 。 

(2) ERF 

套 接 字 也 就 是 基本 双向 数据 通信 机 制 。 套 接 字 是 在 网 络 上 建立 机 器 之 间 通 信 连 接 的 方 
ik. java. net 包 提 供 4 种 套 接 字 : 

* Socket ft TCP 客户 端 API, 通 常用 于 连接 远程 主机 。 

。 ServerSocket 是 TCP 服务 器 API, 通 常 接受 源 于 客户 端 套 接 字 的 连接 。 

。 DatagramSocket 是 UDP 端点 API, 用 于 发 送 和 接收 数据 报 。 

* MulticastSocket 是 DatagramSocket 的 子 类 ,在 处 理 多 播 组 时 使 用 。 

使 用 TCP 套 接 字 的 发 送 和 接收 操作 需要 借助 InputStream 和 OutputStream 来 完成 ， 
这 两 者 是 通过 Socket. getInputStream() 和 Socket. getOutputStream() 方 法 获取 的 。 

(3) 接口 

用 于 描述 网 络 接 口 。NetworkInterface 类 提供 API 以 浏览 和 查询 本 地 机 器 的 所 有 网 络 
接口 (例如 ,以 太 网 连接 或 PPP 端点 ) 。 只 有 通过 该 类 才 可 以 检查 是 否 将 所 有 本 地 接口 都 配 
置 为 支持 IPv6。 

2. 高 级 API 

高 级 API 主要 用 于 处 理 以 下 抽象 。 

(1) URI 

表示 统一 资源 标识 符 。 

(2) URL 

表示 统一 资源 定位 符 。 

(3) 连接 

表示 到 URL 所 指向 资源 的 连接 。 

java. net 包 中 的 许多 类 可 以 提供 更 加 高 级 的 抽象 ,允许 方便 地 访问 网 络 上 的 资源 。 这 
些 类 为 : 

。 URI 是 表示 在 RFC 2396 中 指定 的 统一 资料 标识 符 的 类 。 顾 名 思 义 , 它 只 是 一 个 标 
识 符 , 不 直接 提供 访问 资源 的 方法 。 

URL 是 表示 统一 资源 定位 符 的 类 , 它 既 是 URI 的 旧式 概念 ,又 是 访问 资源 的 方法 。 
。 URLConnection 是 根据 URL 创建 的 ,是 用 于 访问 URL 所 指向 资源 的 通信 连接 。 
此 抽象 类 将 大 多 数 工作 委托 给 底层 协议 处 理 程序 ,如 http 或 ftp。 
HttpURLConnection 是 URLConnection 的 子 类 ,提供 一 些 特定 于 HTTP 协议 的 附 
加 功能 。 
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建议 的 用 法 是 使 用 URI 指定 资源 ,然后 在 访问 资源 时 将 其 转换 为 URL. MX URL 可 
以 获取 URLConnection 以 进行 良好 控制 ,也 可 以 直接 获取 InputStream。 例 如 : 


01 URI uri = new URI("http://www.baidu. com/"); 
02 URLurl = uri.toURL(); 
03 InputStream in = url.openStream(); 


URL 和 URLConnection 都 依赖 于 协议 处 理 程序 ,所 以 协议 处 理 程序 必须 存在 ,和 否则 将 
抛 出 异常 。 此 为 与 URI 的 主要 不 同 点 ,URI 仅 标 识 资源 ,所 以 不 必 访 问 协 议 处 理 程序 。 因 
此 ,尽管 可 能 利用 任何 种 类 的 协议 方案 (例如 ,myproto://myhost. mydomain/resource/) 创 
建 URI, 但 类 似 的 URL 仍 将 试图 实例 化 指定 协议 的 处 理 程序 ,如 果 指 定 协议 的 处 理 程序 不 
存在 , 则 抛 出 异常 。 

默认 情况 下 ,协议 处 理 程序 从 默认 位 置 动态 加 载 。 但 是 ,通过 设置 java. protocol. 
handler. pkgs 系统 属性 也 可 能 增加 搜索 路 径 。 例 如 ,如 果 将 其 设置 为 myapp. protocols, 则 
URL 代码 将 首先 尝试 (对 于 http 而 言 ) 加 载 myapp. protocols. http. Handler, 然后 如 果 失 
败 , 则 尝试 从 默认 位 置 加 载 http. Handler. 

注意 : 处 理 程 序 类 必须 为 抽象 类 URLStreamHandler 的 子 类 。 


4.2 Socket 概述 


Socket 是 面向 客户 /服务 器 模型 而 设计 的 ,针对 客户 和 服务 器 程序 提供 不 同 的 Socket 
系统 调用 ,网 络 中 的 Socket 数据 传输 可 以 理解 为 一 种 特殊 的 1/0. 


4.2.1 什么 是 Socket 通信 


在 网 络 出 现 之 前 的 单机 系统 时 代 , 更 多 的 是 进程 之 间 的 通信 。 由 于 每 个 进程 有 自己 的 
地 址 空间 ,为 了 保证 两 个 进程 的 通信 互 不 干扰 又 协调 工作 ,操作 系统 提供 了 相应 的 设施 。 如 
UNIX 系统 中 的 管道 命名 管道 和 软 中 断 信号 。 而 在 网 络 中 ,两 个 不 同 计算 机 中 的 进程 需要 
通信 首先 要 解决 的 是 进程 识别 的 问题 。 同 一 主机 上 ,不 同 进程 可 以 用 进程 号 作为 唯一 标识 ， 
但 是 在 网 络 环境 里 不 同 的 主机 上 完全 可 以 用 同一 进程 号 ,所 以 用 这 种 方法 来 区 别 进 程 是 不 
可 行 的 。 另 外 ,操作 系统 支持 的 网 络 协议 很 多 ,不 同 协议 的 工作 方式 是 不 一 样 的 ,包括 网 络 
的 地 址 格式 也 不 同 。 因 此 ,还 需要 考虑 不 同 网 络 协议 的 识别 问题 。 

为 了 解决 这 个 问题 ,提出 了 Socket 这 个 概念 。Socket 又 称 为 “ 套 接 字 ”, 用 于 描述 网 络 
地 址 与 端口 0, 它 是 一 个 通信 的 接口 ,是 应 用 层 与 TCP/IP 协议 族 通 信 的 中 间 的 软件 抽象 
层 , 位 于 运输 层 和 网 络 层 之 上 ,又 位 于 应 用 层 之 下 ,作为 一 个 抽象 层 存 在 。 图 4-1 描述 了 





© £ Socket 通信 中 TCP 以 及 UDP 都 是 采用 16 位 的 端口 号 来 识别 应 用 程序 ,服务 器 一 般 都 是 通过 端口 号 来 识别 
的 。 客 户 端 通常 对 它 使 用 的 端口 并 不 关心 ,只 需 保 证 它 是 唯一 的 就 可 以 了 ,客户 端的 端口 号 又 称 为 临时 端口 号 ( 即 存在 
时 间 很 短 ) 。 这 是 因为 它 通常 在 客户 运行 该 客户 端 程序 时 才 存 在 。 端 口号 最 大 范围 是 0 一 65535。 其 中 1 一 1023 的 端口 
号 是 已 经 被 预先 占有 的 服务 端口 号 。 大 多 数 的 临时 端口 分 配 范围 在 1024 一 5000。 大 于 5000 的 端口 号 是 为 其 他 服务 器 
预 留 的 (Internet 上 并 不 常用 ) 。 
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i 应 用 程序 (应 用 层 ) 
有 时 多 个 应 用 程序 可 能 同时 需要 向 同一 个 接口 发 7 

送 数据 。 为 了 区 别 不 同 的 应 用 程序 进程 和 连接 ,许多 计 See 

算 机 操作 系统 为 应 用 程序 与 TCP/IP 协议 交互 提供 了 org pow a 

PRN Socket 的 接口 ,或 者 说 套 接 字 Socket 是 TCP 的 应 

用 编程 接口 API, 通 过 它 应 用 层 就 可 以 访问 TCP 提供 




















TCP/UDP( 传 输 层 ) 














的 服务 。 IP( 网 络 层 ) 
区 分 不 同 应 用 程序 进程 间 的 网 络 通信 和 连接 ,主要 
有 3 个 参数 : 通信 的 目的 IP 地 址 、 使 用 的 传输 层 协议 ARP RARP( 链 路 层 ) 











CTCP 或 UDP) 和 使 用 的 端口 号 。 通 过 将 这 3 PSR a aT MR 
合 起 来 ,与 一 个 Socket 绑 定 ,应 用 层 就 可 以 和 传输 层 通 ds 


id Socket 接口 ,区 分 来 自 不 同 应 用 程序 进程 或 网 络 连接 的 通信 ,实现 数据 传输 的 并 发 服务 。 


4.2.2 Socket 通信 的 基本 步骤 


Socket 通信 的 过 程 可 以 分 为 三 个 步骤 : 服务 器 监听 ,客户 端 请 求 ,连接 确认 。 

CD 服务 器 监听 : 是 服务 器 端 Socke 处 于 等 待 连接 的 状态 ,实时 监控 网 络 状态 。 

(2) 客户 端 请 求 : 是 指 由 客户 端的 Socket 提出 连接 请 求 ,要 连接 的 目标 是 服务 器 端的 
Socket。 为 此 ,客户 端的 Socket 必须 首先 描述 它 要 连接 的 服务 器 的 Socket, 指 出 服务 器 端 
Socket 的 地 址 和 端口 号 ,然后 向 服务 器 端 Socket 提出 连接 请 求 。 

(3) 连接 确认 : 是 指 当 服务 器 端 Socket 监听 到 客户 端 Socket 的 连接 请 求 , 它 就 响应 客 
户 端 Socket 的 请 求 ,建立 一 个 新 的 线程 ,把 服务 器 端 Socket 的 描述 发 给 客户 端 ,一 旦 客户 
端 确认 了 此 描述 ,连接 就 建立 好 了 。 而 服务 器 端 Socket 继续 处 于 监听 状态 ,继续 接收 其 他 
客户 端 Socket 的 连接 请 求 。 

因此 ,Socket 可 以 看 成 在 两 个 程序 进行 通信 连接 中 的 一 个 端点 ,是 连接 应 用 程序 和 网 
络 驱动 程序 的 桥梁 ,Socket 在 应 用 程序 中 创建 ,通过 绑 定 与 网 络 驱动 建立 关系 。 此 后 ,应 用 
程序 发 送 给 Socket 的 数据 ,由 Socket 通过 网 络 驱动 程序 向 网 络 上 发 送出 去 。 计 算 机 从 网 
络 上 收 到 与 该 Socket 绑 定 IP 地 址 和 端口 号 相关 的 数据 后 ,由 网 络 驱动 程序 交 给 Socket, V 
用 程序 便 可 从 该 Socket 中 提取 接收 到 的 数据 ,网 络 应 用 程序 就 是 这 样 通过 Socket 进行 数 
据 的 发 送 与 接收 的 。 

1. Socket 通信 连接 过 程 

Socket 连接 建立 是 基于 TCP 的 连接 建立 过 程 ,TCP 的 连接 需要 通过 三 次 握手 报 文 来 
完成 。 在 TCP 协议 中 ,是 通过 3 个 TCP 格式 的 IP 数据 报 来 实现 的 。 

TCP 格式 的 IP 数据 报 中 包含 着 TCP 首部 ,TCP 首部 信息 中 包含 着 对 每 一 个 数据 报 具 
体内 容 的 描述 。 这 些 首部 包括 以 下 内 容 。 

* SYN: 同步 序号 用 来 发 起 一 个 连接 。 当 发 起 连接 时 ,SYN 就 会 被 设置 成 1。 因 为 

TCP 协议 要 求 数据 传送 是 可 靠 的 ,其 实现 方式 就 是 对 传输 数据 的 每 一 个 字 节 按 顺 
序 编号 。 初 始 序列 号 ISN 并 非 从 0 开始 ,而 是 一 个 随时 间 周 而 复 始 变化 的 32 位 无 
符号 整数 。 发 起 连接 后 ,假设 发 起 连接 一 方 的 ISN 为 ”因为 SYN 会 在 数据 部 分 添 
加 一 个 字 节 表示 这 是 一 个 新 连接 的 开始 ,所 以 这 时 字 节 序号 就 成 了 ntl. 
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* ACK: 确认 序号 有 效 。TCP 协议 要 求 自动 检验 数据 的 可 靠 性 ,实现 方式 就 是 检验 字 
节 序 号 是 否 正确 地 衔接 。 假 如 接收 数据 的 一 方 序 号 已 经 是 mm, 那么 其 返回 给 发 送 方 
确认 有 效 的 序号 就 是 m 十 1。 一 旦 连接 ,ACK 始终 设置 为 1, 即 表示 序号 有 效 , 并 且 
在 所 有 数据 报 中 总 是 存在 。 
Socket 连接 建立 时 的 三 次 握手 过 程 是 : 开始 建立 TCP 连接 时 需要 发 送 同 步 SYN 报 
文 ,然后 等 待 确认 报 文 SYN 十 ACK, 最 后 再 发 送 确认 报 文 ACK。 具 体 过 程 如 下 。 
。 客户 端 发 送 SYN 包 (SYN==n) 到 服务 器 ,并 进入 SYN. SEND 状态 ,等 待 服务 器 确认 。 
。 服务 器 端 收 到 第 一 次 握手 请 求 的 数据 报 后 开始 构建 反馈 的 数据 报 。 反 馈 数据 报 包 
括 两 个 部 分 (SYN 十 ACK): 第 一 部 分 是 将 连接 请 求 的 序号 反馈 回去 ,因为 SYN 本 
身 占 了 一 个 字 节 ,所 以 反馈 回去 的 序号 就 是 ACK(n 十 1); 第 二 部 分 是 向 客户 端 发 起 
SYN 连接 请 求 , 包 含 这 个 新 连接 的 ISN, 设 其 值 为 m. 
。 客户 端 收 到 服务 器 的 SYN 十 ACK 包 , 向 服务 器 发 送 确 认 包 ACK(m 十 1) ,因为 SYN 
占 了 一 个 字 节 ,所 以 反馈 给 服务 器 端的 序号 是 m 十 1。 
握手 过 程 中 传送 的 包 里 不 包含 数据 ,三 次 握手 完毕 后 ,客户 端 与 服务 器 才 正式 开始 传送 
数据 。 理 想 状态 下 ,TCP 连接 一 旦 建立 ,在 通信 双方 中 的 任何 一 方 主动 关闭 连接 之 前 ,TCP 
连接 都 将 被 一 直 保 持 下 去 。 
2. Socket HAMA BRE 
TCP 的 断 开 连 接 需 要 通过 四 次 握手 报 文 来 完成 ,在 TCP 协议 中 ,是 通过 TCP 格式 的 
IP 数据 报 来 实现 的 。 
TCP 格式 的 IP 数据 报 中 包含 着 TCP 首部 。 在 断 开 连接 时 ,TCP 首部 信息 中 包含 着 对 
每 一 个 数据 报 具 体内 容 的 描述 。 
FIN 表示 发 送 端 完成 发 送 。 与 SYN XM. FIN 也 会 在 数据 部 分 占用 一 个 字 节 ,表示 这 
是 一 个 结束 符号 。 由 于 TCP 连接 是 全 双 工 的 ,因此 每 个 方向 都 必须 单独 进行 关闭 。 原 则 是 
当 一 方 完 成 它 的 数据 发 送 任务 后 ,就 能 发 送 一 个 FIN 来 终止 这 个 方向 的 连接 。 收 到 一 个 
FIN 只 意味 着 这 一 方向 上 没有 数据 流动 ,一 个 TCP 连接 在 收 到 一 个 FIN 后 仍 能 发 送 数据 。 
首先 进行 关闭 的 一 方 将 执行 主动 关闭 ,而 另 一 方 执行 被 动 关闭 。 
Socket 开始 断 开 TCP 连接 时 需要 发 送 FIN 报 文 ,等 待 确认 报 文 ACK ,然后 由 接收 方 
再 次 发 给 发 送 方 一 个 断 开 连接 FIN 报 文 ,等 待 原 发 送 方 确认 报 文 ACK ,这样 就 断 开 了 连 
接 。 具 体 过 程 如 下 : 
(D TCP 客户 端 发 送 一 个 FIN, 用 来 关闭 客户 到 服务 器 的 数据 传送 。 
© 服务 器 收 到 这 个 FIN, 它 发 回 一 个 ACK ,确认 序号 为 收 到 的 序号 加 1。 与 SYN 一 
样 ,一 个 FIN 将 占用 一 个 序号 。 
@ 服务 器 关闭 客户 端的 连接 ,发 送 一 个 FIN 给 客户 端 。 
@ 客户 端 发 回 ACK 报 文 进行 确认 ,并 将 确认 序号 设置 为 收 到 序号 加 1。 


4.3 Android 中 的 Socket 编程 


本 节 介 绍 Android 中 与 Socket 编程 密切 相关 的 类 ,并 通过 一 个 案例 介绍 Android 中 进 
行 Socket 编程 的 基本 方法 和 步骤 。 
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4.3.1 Socket 相关 类 


1. InetAddress 

IP 地 址 是 IP 使 用 的 32 位 (IPv4) 或 者 128 位 (IPv6) 位 无 符号 数字 , 它 是 传输 层 协议 
TCP、UDP 的 基础 。java. net. InetAddress 是 Java 对 IP 地 址 的 封装 ,在 java. net 中 有 许多 
类 都 使 用 到 了 InetAddress, 包 括 ServerSocket, Socket , DatagramSocket 等 。 

InetAddress 的 实例 对 象 包含 以 数字 形式 保存 的 IP 地址 ,同时 还 可 能 包含 主机 名 (如 果 
使 用 主机 名 来 获取 InetAddress 的 实例 ,或 者 使 用 数字 来 构造 ,并 且 启 用 了 反 向 主机 名 解析 
的 功能 ) InetAddress 类 提供 了 将 主机 名 解析 为 TP 地 址 (或 反之 ) 的 方法 。 

InetAddress 对 域名 进行 解析 是 使 用 本 地 机 器 配置 或 者 网 络 命名 服务 (如 域名 系统 
(Domain Name System,DNS) 和 网 络 信息 服务 (Network Information Service, NIS)) 来 实 
现 。 对 于 DNS 来 说 ,本 地 需要 向 DNS 服务 器 发 送 查询 的 请 求 ,然后 服务 器 根据 一 系列 的 操 
作 , 返 回 对 应 的 IP 地址。 为 了 提高 效率 ,通常 本 地 会 缓存 一 些 主机 名 与 IP 地 址 的 映射 ,这 
样 访问 相同 的 地 址 ,就 不 需要 重复 发 送 DNS 请 求 了 。 在 java. net. InetAddress 类 中 同样 采 
用 了 这 种 策略 。 默 认 情 况 下 ,会 缓存 一 段 有 限时 间 的 映射 。 对 于 主机 名 解析 不 成 功 的 结果 ， 
会 缓存 非常 短 的 时 间 (10 秒 ) 来 提高 性 能 。 

InetAddress 的 构造 方法 不 是 公开 的 (因此 ,不 能 直接 创建 InetAddress 对 象 , 如 
InetAddress ia = new InetAddress () 是 错误 的 ), 所 以 需要 通过 它 提供 的 静态 方法 ( 即 工厂 
模式 ) 来 获取 ,有 以 下 的 方法 。 

* static InetAddress[ ] getAllByName(String host); 在 给 定 主机 名 的 情况 下 ,根据 系 
统 上 配置 的 名 称 服务 返回 其 TP 地 址 所 组 成 的 数组 。 
static InetAddress getByAddressCbyte[ ] addr): 在 给 定 原始 IP 地 址 的 情况 下 ,返回 
InetAddress 对 象 。 
static InetAddress getByAddress(String host,byte[] addr); 根据 提供 的 主机 名 和 
IP 地 址 创建 InetAddress。 
static InetAddress getByName(String host); 返回 一 个 InetAddress WH ,该 对 象 包 
含 了 一 个 与 host 参数 指定 的 域名 或 IP 地 址 ,对 于 指定 的 主机 如 果 没 有 IP 地 址 存 
在 ,那么 方法 将 抛 出 一 个 UnknownHostException 异常 对 象 。 例 如 : 


01 InetAddress ia = InetAddress. getBYName("www.baidu.com" ) ; 
02 InetAddress ia = InetAddress. getByName("111.13.100.92"); 


* static InetAddress getLocalHostO : 返回 一 个 InetAddress 对 象 , 这 个 对 象 包含 了 
本 地 机 域名 和 TP 地址。 
在 这 些 静态 方法 中 ,最 为 常用 的 应 该 是 getByName(String host) 方 法 ,只 需要 传人 目标 
主机 的 名 字 ,InetAddress 就 会 尝试 连接 DNS 服务 器 并 且 获 取 IP 地 址 。 
InetAddress 对 象 可 以 映射 地 址 ,也 可 以 通过 其 获取 相关 属性 。 常 用 的 方法 如 下 。 
* String getHostName(): 用 于 获得 InetAddress 映射 地 址 对 象 中 的 域名 或 者 主 
机 名 。 
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01 String dominName = inetAddress.getHostName(); 


* String getHostAddress(); 返回 一 个 InetAddress 映射 地 址 对 象 的 IP 地 址 信息 。 

01 String ip = inetAddress.getHostAdress(); 

注意 : 这 些 方法 可 能 会 抛 出 的 异常 。 如 果 安 全 管理 器 不 允许 访问 DNS 服务 器 或 禁止 
网 络 连接 ,SecurityException 会 抛 出 。 如 果 找 不 到 对 应 主机 的 IP 地 址 ,或 者 发 生 其 他 网 络 


1/0 错误 ,这 些 方 法 会 抛 出 UnknowHostException。 
下 面 的 方法 演示 了 获取 本 地 IP 地 址 的 方法 。 


01 public static String getLocalHostIp() { 


02 

03 try ( 

04 Enumeration < NetworkInterface > en = NetworkInterface 
05 . getNetworkInterfaces(); 

06 

07 while (en. hasMoreElements()) { 

08 NetworkInterface nif = en.nextElement(); 

09 Enumeration < InetAddress > inet = nif.getInetAddresses(); 
10 

11 while (inet. hasMoreElements()) { 

12 InetAddress ip = inet. nextElement(); 

13 if (! ip. isLoopbackAddress( ) 

14 && InetAddressUtils. isIPv4Address( ip 
15 .getHostAddress())) { 

16 return ip.getHostAddress(); 

17 } 

18 } 

19 

20 } 

21 } catch (SocketException e) { 

22 Log. e("InetAddressActivity", "获取 本 地 IP 地 址 失败 "); 
23 e. printStackTrace( ) ; 

24 j 

25 

26 return IP DEFAULT; //"0.0.0.0" 

Eu ye 

2. Socket 


java. net. Socket 类 用 于 描述 IP 地 址 和 端口 ,是 一 个 通信 链 的 句柄 ,可 以 实现 客户 端 套 
接 字 。 应 用 程序 通过 Socket 向 网 络 发 出 请 求 或 者 应 答 网 络 请 求 。 
在 网 络 连接 成 功 时 ,应 用 程序 两 端 都 会 产生 一 个 Socket 实例 ,通过 操作 这 个 实例 ,完成 
所 需 的 会 话 。 对 于 一 个 网 络 连接 来 说 , 套 接 字 是 平等 的 ,并 没有 差别 ,不 会 因为 在 服务 器 端 
或 在 客户 端 而 产生 不 同 级 别 。 不 管 是 Socket 还 是 ServerSocket. 它们 的 工作 都 是 通过 
SocketImpl 类 及 其 子 类 完成 的 。 
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COD 常用 构造 方法 


java. net. Socket 继承 自 java. lang. Object。 下 面 介 绍 两 个 常见 的 构造 方法 。 


。 Socket(InetAddress address, int port); 创建 一 个 流 套 接 字 并 将 其 连接 到 指定 IP 地 


址 的 指定 端口 号 。 


Socket(String host, int port): 创建 一 个 流 套 接 字 并 将 其 连接 到 指定 主机 上 的 指定 


端口 号 。 


两 个 构造 方法 都 创建 了 一 个 基于 Socket 的 连接 服务 器 端 流 套 接 字 的 流 套 接 字 。 对 于 
第 一 个 方法 中 的 InetAddress 子 类 对 象 , 通 过 address 参数 获得 服务 器 主机 的 IP 地 址 。 对 
于 第 二 个 方法 ,host 参数 包 被 分 配 到 InetAddress 对 象 中 ,如 果 没 有 IP 地 址 与 host 参数 相 
一 致 ,那么 将 抛 出 UnknownHostException 异常 对 象 。 两 个 方法 都 通过 port 参数 获得 服务 
器 的 端口 号 。 假 设 已 经 建立 了 连接 ,网 络 API 将 在 客户 端 基于 Socket 的 流 套 接 字 中 捆绑 客 
户 程序 的 IP 地 址 和 任意 一 个 端口 号 ,否则 两 个 方法 都 会 抛 出 一 个 IOException 对 象 。 

如 果 应 用 程序 已 指定 套 接 字 工 厂 , 则 调用 该 工厂 的 createSocketImpl() 方 法 来 创建 实 
际 套 接 字 实 现 。 否 则 创建 “普通 ” 套 接 字 。 如 果 有 安全 管理 器 , 则 使 用 主机 地 址 和 port 作为 
参数 调用 其 checkConnect() 方 法 。 这 可 能 会 导致 SecurityException 异常 。 

(2) 常用 方法 

下 面 介 绍 几 个 使 用 最 频繁 的 方法 。 


InputStream getInputStream(); 返回 此 套 接 字 的 输入 流 。 关闭 了 返回 的 

InputStream, 所 以 将 关闭 关联 套 接 字 。 

如 果 此 套 接 字 具有 关联 的 通道 , 则 所 得 的 输入 流 会 将 其 所 有 操作 委托 给 通道 。 如 果 通 

道 为 非 阻 塞 模式 , 则 输入 流 的 read() 操 作 将 抛 出 HiegalBlockingModeException。 在 非 

正常 条 件 下 ,底层 连接 可 能 被 远程 主机 或 网 络 软件 中 断 ( 例 如 ,TCP 连接 情况 下 的 连接 

3880. 。 当 网 络 软件 检测 到 中 断 的 连接 时 ,将 对 返回 的 输入 流 应 用 以 下 操作 ， 

> 网 络 软件 可 能 丢弃 经 过 套 接 字 缓 冲 的 字 节 。 网 络 软件 没有 丢弃 的 字 节 可 以 使 用 
read() 读 取 。 

> 如 果 没 有 任何 字 节 在 套 接 字 上 缓冲 ,或 者 read() 已 经 消耗 了 所 有 缓冲 的 字 节 , 则 
对 read(O) 的 所 有 后 续 调 用 都 将 抛 出 IOException。 

> 如 果 没 有 任何 字 节 在 套 接 字 上 缓冲 ,并 且 没 有 使 用 close() 关 闭 套 接 字 , 则 
available() 将 返回 0。 

OutputStream getOutputStream(): 返回 此 套 接 字 的 输出 流 。 因 关闭 了 返回 的 

OutputStream, 所 以 将 关闭 关联 套 接 字 。 

如 果 此 套 接 字 具 有 关联 的 通道 , 则 得 到 的 输出 流 会 将 其 所 有 操作 委托 给 通道 。 如 果 通 

道 为 非 阻 塞 模式 , 则 输出 流 的 write() 操 作 将 抛 出 TllegalBlockingModeException 异常 。 

void connect(SocketAddress endpoint): 将 此 套 接 字 连 接 到 服务 器 。isConnected() 

方法 返回 套 接 字 的 连接 状态 。 

void connect(SocketAddress endpoint, int timeout): 将 此 套 接 字 连 接 到 服务 器 ,并 

指定 一 个 超时 值 。timeout 等 于 0 表示 无 限 超时 。 在 建立 连接 或 者 发 生 错 误 之 前 ， 

连接 一 直 处 于 阻塞 状态 。 

void bind (SocketAddress bindpoint): 将 套 接 字 绑 定 到 本 地 地 址 。 如 果 地 址 为 
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null, 则 系统 将 挑选 一 个 临时 端口 和 一 个 有 效 本 地 地 址 来 绑 定 套 接 字 。isBound() 方 
法 返回 套 接 字 的 绑 定 状态 。 
void close(): 关闭 此 套 接 字 。isClosed() 方 法 返回 套 接 字 的 关闭 状态 。 
* InetAddress getInetAddress(): 返回 套 接 字 连 接 的 地 址 。 
InetAddress getLocalAddressO : 获取 套 接 字 绑 定 的 本 地 地 址 。 
。 SocketAddress getLocalSocketAddressO ; 返回 此 套 接 字 绑 定 的 端点 的 地 址 。 如 果 
尚未 绑 定 , 则 返回 null; 
SocketAddress getRemoteSocketAddress(): 返回 此 套 接 字 连接 的 端点 的 地 址 ,如 
果 未 连接 , 则 返回 null, 

* int getPort(): 返回 此 套 接 字 连接 到 的 远程 端口 。 

* int getLocalPort(): 返回 此 套 接 字 绑 定 到 的 本 地 端口 。 

3. ServerSocket 

在 Client/Server 通信 模式 中 ,服务 器 端 需要 创建 监听 特定 端口 的 ServerSocket, java. 
net. ServerSocket 所 封装 的 底层 操作 会 作为 服务 的 提供 端 来 监听 某 一 个 网 络 端口 ,并 等 待 
客户 端的 连接 请 求 。 

CD 构造 方法 

java. net. ServerSocket 继承 自 java. lang. Object, 构 造 方法 包括 以 下 几 种 。 

(D ServerSocketO : 创建 非 绑 定 服务 器 套 接 字 。 

ServerSocket 不 带 参 数 的 默认 构造 方法 创建 的 ServerSocket 不 与 任何 端口 绑 定 , 接 下 
来 还 需要 通过 bind() 方 法 与 特定 端口 绑 定 。 这 个 默认 构造 方法 的 用 途 是 ,允许 服务 器 在 绑 
定 到 特定 端口 之 前 先 设 置 ServerSocket 的 一 些 选 项 。 因 为 一 旦 服务 器 与 特定 端口 绑 定 , 有 
些 选 项 就 不 能 再 改变 了 。 

Q) ServerSocket(int port): 创建 绑 定 到 特定 端口 的 服务 器 套 接 字 。 

如 果 port 为 0, 则 在 所 有 空闲 端口 上 创建 套 接 字 。 传 人 连接 指示 (对 连接 的 请 求 ) 的 最 
大 队列 长 度 被 设置 为 50。 管 理 客户 连接 请 求 的 任务 是 由 操作 系统 来 完成 的 ,如 果 队 列 满 时 
收 到 连接 指示 , 则 拒绝 该 连接 。 

对 于 客户 进程 ,如 果 它 发 出 的 连接 请 求 被 加 入 服务 器 的 队列 中 ,就 意味 着 客户 与 服务 器 
的 连接 建立 成 功 , 客 户 进程 从 Socket 构造 方法 中 正常 返回 。 如 果 客 户 进程 发 出 的 连接 请 求 
被 服务 器 拒绝 ,Socket 构造 方法 就 会 抛 出 ConnectionException。 

如 果 运 行 时 无 法 绑 定 到 port 端口 ,会 抛 出 BindException 异常 。BindException 一 般 是 
由 两 种 原因 造成 的 : 端口 已 经 被 其 他 服务 器 进程 占用 ; 在 某 些 操作 系统 中 ,如 果 没 有 以 超 
级 用 户 的 身份 来 运行 服务 器 程序 ,那么 操作 系统 不 允许 服务 器 绑 定 到 1—1023 的 端口 。 

(3) ServerSocket(int port, int backlog): 利用 指定 的 backlog 创建 服务 器 套 接 字 并 将 
其 绑 定 到 指定 的 本 地 端口 号 ,backlog 将 覆盖 操作 系统 限定 的 队列 的 最 大 长 度 。 

传人 连接 指示 (对 连接 的 请 求 ) 的 最 大 队列 长 度 被 设置 为 backlog 参数 。 如 果 队 列 满 时 
收 到 连接 指示 , 则 拒绝 该 连接 。backlog 参数 必须 是 大 于 0 的 正 值 。 如 果 传 递 的 值 等 于 或 小 
于 0, 则 使 用 默认 值 。 

对 于 ServerSocket(int port) fll ServerSocket(int port, int backlog) 方 法 ,如 果 应 用 程序 
已 指定 服务 器 套 接 字 工厂 , 则 调用 该 工厂 的 createSocketImpl ) 方 法 来 创建 实际 套 接 字 实 
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现 ,否则 创建 “普通 ” 套 接 字 。 如 果 存在 安全 管理 器 , 则 首先 使 用 port 参数 作为 参数 调用 其 
checkListen() 方 法 ,以 确保 允许 该 操作 ,这 可 能 会 导致 SecurityException 异常 。 


@ ServerSocket(int port, int backlog, InetAddress bindAddr): 使 用 指定 的 端口 、 侦 


听 backlog 和 要 绑 定 到 的 本 地 IP 地 址 创建 服务 器 。 


bindAddr 参数 可 以 在 ServerSocket 的 多 宿主 主机 上 使 用 , ServerSocket 仅 接受 对 其 地 


址 之 一 的 连接 请 求 。 如 果 bindAddr 为 null, 则 默认 接受 所 有 本 地 地 址 上 的 连接 。 端 口 必须 
为 0~65535( 包 括 两 者 ) 。 


(2) 常用 方法 
下 面 介绍 几 个 使 用 最 频繁 的 方法 。 


* Socket acceptO : 从 连接 请 求 队列 中 取出 一 个 客户 的 连接 请 求 ,然后 创建 与 客户 连 
接 的 Socket 对 象 ,并 将 它 返回 。 如 果 队 列 中 没有 连接 请 求 ,accept() 方 法 就 会 一 直 
等 待 ,直到 接收 到 了 连接 请 求 才 返回 。 只 有 当 服 务 器 进程 通过 ServerSocket 的 
accept() 方 法 从 队列 中 取出 连接 请 求 ,使 队列 腾 出 空位 时 ,队列 才能 继续 加 入 新 的 连 
接 请 求 。 
void bind(SocketAddress endpoint) ; 将 ServerSocket 绑 定 到 特定 地 址 (CIP 地 址 和 
端口 号 ) 。 如 果 地 址 为 null, 则 系统 将 挑选 一 个 临时 端口 和 一 个 有 效 本 地 地 址 来 绑 
定 套 接 字 。isBound() 方 法 返回 ServerSocket 的 绑 定 状态 。 只 要 ServerSocket 已 经 
与 一 个 端口 绑 定 ,即使 它 已 经 被 关闭 ,isBound() 方 法 也 会 返回 true, 
* void bind(SocketAddress endpoint, int backlog) : 将 ServerSocket 绑 定 到 特定 地 址 
CIP 地 址 和 端口 号 ) backlog 参数 必须 是 大 于 0 的 正 值 。 如 果 传 递 的 值 等 于 或 小 
于 0, 则 使 用 默认 值 。 


说 明 : bind() 方 法 中 要 有 表达 地 址 和 端口 的 重要 参数 ,类 型 为 SocketAddress, 而 应 用 


中 使 用 子 类 InetSocketAddress。 常 用 的 实现 方式 有 以 下 几 种 。 
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01 InetSocketAddress ia = new InetSocketAddress(int port); 
02  InetSocketAddress ia = new InetSocketAddress(InetAddress addr, int port); 
03  InetSocketAddress ia = new InetSocketAddress(String hostname, int port); 


void closeO : 使 服务 器 释放 占用 的 端口 ,并 且 断 开 与 所 有 客户 的 连接 。 在 accept) 

中 所 有 当前 阻塞 的 线程 都 将 会 抛 出 SocketException。 如 果 此 套 接 字 有 一 个 与 之 关 

联 的 通道 , 则 关闭 该 通道 。isClosed() 方 法 返回 ServerSocket 的 关闭 状态 。 只 有 执 

行 了 ServerSocket 的 close () Jy #, isClosed () 方 法 才 返 回 true; 否则 ,即使 

ServerSocket 还 没有 和 特定 端口 绑 定 ,isClosed() 方 法 也 会 返回 false, 

* InetAddress getInetAddress(): 返回 此 服务 器 套 接 字 的 本 地 地 址 。 如 果 套 接 字 是 
未 绑 定 的 , 则 返回 null; 

。 SocketAddress getLocalSocketAddressO : 返回 此 套 接 字 绑 定 的 端点 的 地 址 ,如 果 
尚未 绑 定 , 则 返回 null. 

* int getLocalPortO : 返回 此 套 接 字 在 其 上 侦 听 的 端口 。 如 果 尚 未 绑 定 套 接 字 , 则 返 
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e protected void implAccept (Socket s); ServerSocket 的 子 类 使 用 此 方法 重 写 accept() 
以 返回 它们 自己 的 套 接 字 子 类 。 


4.3.2 实现 Socket 通信 


1. 客户 端 编程 

客户 端 是 Socket 网 络 编程 中 首先 发 起 连接 的 程序 ,客户 端的 编程 主要 由 三 个 步骤 
实现 。 

(1) 建立 网 络 连接 

客户 端 Socket 编程 的 第 一 步 是 建立 网 络 连接 。 在 建立 网 络 连接 时 需要 指定 连接 到 的 
服务 器 的 TP 地 址 和 端口 号 ,建立 完成 以 后 ,会 形成 一 条 虚拟 的 连接 ,后 续 的 操作 就 可 以 通过 
该 连接 实现 数据 交换 了 。 

(2) 交换 数据 

连接 建立 以 后 ,交换 数据 严格 按照 请 求 响应 模型 进行 ,由 客户 端 发 送 一 个 请 求 数据 到 服 
务 器 ,服务 器 反馈 一 个 响应 数据 给 客户 端 , 如 果 客 户 端 不 发 送 请 求 则 服务 器 端 就 不 响应 。 根 
据 逻 辑 需 要 ,可 以 多 次 交换 数据 ,但 是 必须 遵循 请 求 响应 模型 。 

(3) 关闭 网 络 连接 

在 数据 交换 完成 以 后 ,关闭 网 络 连 接 ,释放 程序 占用 的 端口 ,内存 等 系统 资源 ,结束 网 络 
编程 。 

下 面 通过 一 个 实例 演示 客户 端 Socket 编程 的 一 般 步骤 。 

CD 用 服务 器 的 IP 地 址 和 端口 号 实例 化 Socket 对 象 。 

在 ClientActivity 的 onCreate() 生 命 周期 方法 中 ,调用 如 下 代码 初始 化 一 个 客户 端 
线程 。 

提示 : Android 为 了 防止 应 用 的 ANR Caplication Not Response) 异 常 ,在 Android 
Honeycomb 及 之 后 的 API 版 本 中 ,对 UI 线程 进行 联网 操作 是 不 允许 的 。 如 果 有 网 络 操 
作 , 会 抛 出 NetworkOnMainThreadException 的 异常 。 


01 if(_serverPort > 0 && serverAddress != null)( 


02 this. clientThread - new Thread(new ClientThread()); 
03 this. clientThread. start(); 

04 try{ 

05 this. clientThread. join(); 

06 ]catch (Exception e) { 

07 e. printStackTrace( ) ; 

08 } 

09 } 


其 中 ,ClientThread 的 代码 如 下 : 


01 final class ClientThread implements Runnable ( 
02 

03 @Override 

04 public void run() { 

05 
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06 try { 

07 InetAddress serverAddr - InetAddress.getByName( serverAddress); 
08 _socket = new Socket(serverAddr, serverPort); 
09 } catch (UnknownHostException el) { 

10 el.printStackTrace(); 

11 } catch (IOException el) { 

12 el. printStackTrace( ) ; 

13 } 

14 } 

15 

no} 


其 中 的 07 一 08 行 实例 化 一 个 Socket 对 象 。 

@ 调用 connect() 方 法 ,连接 到 服务 器 上 。 

@ 将 发 送 到 服务 器 的 IO 流 填充 到 IO 对 象 里 ,比如 BufferedReader()/PrintWriter()。 

@ 利用 Socket 提供 的 getInputStream() 和 getOutputStream O 77 3 Hw 1/O Hi x 
象 ,向 服务 器 发 送 数据 流 。 

例如 ,在 ClientActivity 中 , 单 击 界面 中 的 “发 送 ” 按 钮 后 ,调用 sendToServer() 方 法 向 
服务 端 发 送 数据 ,代码 如 下 : 


01 public void sendToServer(String datas){ 


02 try { 

03 PrintWriter out = new PrintWriter(new BufferedWriter( 
04 new OutputStreamWriter(_socket. getOutputStream())), 
05 true) ; 

06 out. println(datas); 

07 } catch (UnknownHostException e) { 

08 e. printStackTrace( ) ; 

09 } catch (IOException e) { 

10 e. printStackTrace( ) ; 

EE ] catch (Exception e) ( 

12 e. printStackTrace( ) ; 

13 } 

14 } 


© 通信 完成 后 ,关闭 打开 的 1/O 对 象 和 Socket. 
例如 ,下 面 代码 的 05 行将 客户 端 线程 置 为 Interrupted 状态 。 


01 @Override 
02 protected void onStop() { 


03 super. onStop() ; 

04 try{ 

05 this. clientThread. interrupt() ; 
06 ]catch (Exception e) { 

07 e. printStackTrace( ) ; 

08 } 

09 } 
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当 一 个 Socket 对 象 被 关闭 ,就 不 能 再 通过 它 的 输入 流 和 输出 流 进行 IO 操作 ,否则 会 
导致 IOException 异常 。 为 了 确保 关闭 Socket 的 操作 总 是 被 执行 ,强烈 建议 把 这 个 操作 放 
在 finally 代码 块 中 。 例 如 : 


OL try 
02 cen 
03 } catch (UnknownHostException e) { 


04 e. printStackTrace(); 
05 } catch (IOException e) { 
06 e. printStackTrace(); 
07 } finally { 

08 try { 

09 client. close(); 

10 } catch (Exception e) { 
(mis e. printStackTrace(); 
12 } 

23 

2. 服务 端 编程 


服务 端 是 在 Socket 网 络 编 程 中 被 动 等 待 连接 的 程序 ,服务 端的 编程 步骤 和 客户 端 不 
同 , 是 由 以 下 四 个 步骤 实现 的 。 

COD 监听 端口 

服务 端 属 于 被 动 等 待 连接 ,所 以 服务 端 启动 以 后 ,不 需要 发 起 连接 ,而 只 需要 监听 本 地 
某 个 固定 端口 即 可 。 这 个 端口 就 是 服务 端 开 放 给 客户 端的 端口 ,服务 端 程序 运行 的 本 地 IP 
地 址 就 是 服务 端 程序 的 IP 地 址 。 

(2) 获得 连接 

当 客 户 端 连接 到 服务 端 时 ,服务 端 就 可 以 获得 一 个 连接 ,这 个 连接 包含 客户 端的 信息 ， 
例如 客户 端 IP 地 址 等 ,服务 端 和 客户 端 也 通过 该 连接 进行 数据 交换 。 一 般 在 服务 端 编程 
中 , 当 获 得 连接 时 ,需要 开启 专门 的 线程 处 理 该 连接 ,每 个 连接 都 由 独立 的 线程 实现 。 

(3) 交换 数据 

服务 端 通过 获得 的 连接 进行 数据 交换 。 服 务 端 的 数据 交换 步骤 是 首先 接收 客户 端 发 送 
过 来 的 数据 ,然后 进行 逻辑 处 理 , 再 把 处 理 以 后 的 结果 数据 发 送 给 客户 端 。 简 单 来 说 ,就 是 
先 接收 再 发 送 , 这 个 和 客户 端的 数据 交换 数 序 不 同 。 当 然 ,服务 端的 数据 交换 也 是 可 以 多 次 
进行 的 。 在 数据 交换 完成 以 后 ,关闭 和 客户 端的 连接 。 

(4) 关闭 连接 

当 服 务 器 程序 关闭 时 ,需要 关闭 服务 端 ,通过 关闭 服务 端 使 得 服务 器 监听 的 端口 以 及 占 
用 的 内 存 可 以 释放 出 来 ,实现 连接 的 关闭 。 

下 面 通过 一 个 实例 演示 服务 端 ServerSocket 编程 的 一 般 步骤 。 

CD 在 服务 器 上 用 一 个 端口 来 实例 化 一 个 ServerSocket 对 象 。 此 时 ,服务 器 就 可 以 用 这 
个 端口 时 刻 监听 从 客户 端 发 来 的 连接 请 求 。 

在 ServerActivity 的 onCreate() 生 命 周 期 方法 中 ,调用 如 下 代码 初始 化 一 个 服务 端 
线程 : 
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01 if( port» 0){ 


02 _serverThread = new Thread(new ServerRunnable()) ; 
03 _serverThread. start(); 
04 } 


其 中 ,ServerRunnable 代码 如 下 : 


01 final class ServerRunnable implements Runnable{ 


02 

03 @Override 

04 public void run() { 

05 Socket socket = null; 

06 

07 try{ 

08 _serverSocket = new ServerSocket(_port); 
09 ]catch (IOException e){ 

10 e. printStackTrace( ) ; 

shh return; 

12 } 

13 

14 while (! Thread. currentThread(). isInterrupted()) { 
15 

16 try { 

17 _socket = _serverSocket. accept() ; 
18 CommunicationThread commThread = 

19 new CommunicationThread(_socket); 
20 new Thread(commThread).start(); 

21 

22 } catch (IOException e) { 

23 e. printStackTrace(); 

24 } 

25 } 

26 } 

ep 


@ 调用 ServerSocket 的 accept() 方 法 开始 监听 从 端口 发 来 的 连接 请 求 。 
© 利用 accept() 方 法 返回 的 客户 端的 Socket 对 象 进行 读 写 I/O 的 操作 。 如 上 面 代码 
的 第 17 行 。 其 中 负责 数据 交互 的 CommunicationThread 代码 如 下 : 


01 final class CommunicationThread implements Runnable { 


02 

03 private Socket clientSocket; 

04 private BufferedReader input; 

05 

06 public CommunicationThread(Socket clientSocket) ( 
07 

08 this.clientSocket = clientSocket; 

09 
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10 try { 

1 this. input = new BufferedReader( new InputStreamReader( 
72 this.clientSocket.getInputStream())); 
13 } catch (IOException e) { 

14 e. printStackTrace( ) ; 

15 } 

16 } 

17 

18 public void run() { 

19 

20 while (!Thread. currentThread(). isInterrupted()) { 
T try { 

22 final String read = input. readLine(); 

23 

24 runOnUiThread( new Runnable() { 

25) @Override 

26 public void run() { 

27 onDataReceive(read); 

28 } 

29 D: 

30 } catch (IOException e) { 

Sr e. printStackTrace( ) ; 

32 } 

33 } 

34 } 

35 

zo y 


其 中 ,第 27 行 的 onDataReceive() 方 法 负责 将 从 客户 端 收 到 的 数据 显示 在 用 户 界面 上 。 
© 通信 完成 后 ,关闭 打开 的 IO 流 和 ServerSocket 对 象 。 例 如 : 


01 @Override 
02 protected void onStop() ( 


03 super. onStop() ; 

04 try{ 

05 _serverSocket. close() ; 
06 }eatch (Exception e) { 

07 e. printStackTrace( ) ; 
08 } 

09 try { 

10 _serverThread. interrupt(); 
alt }catch (Exception e) { 

2 e. printStackTrace(); 
13 } 

14 ] 


下 面 介 绍 模拟 器 之 间 的 Socket 通信 。 
两 个 模拟 器 之 间 Socket 通信 设置 的 基本 步骤 如 下 。 
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CD 获取 模拟 器 的 IP. 

D 启动 一 个 模拟 器 。 

© 启动 Windows 的 命令 行 窗口 ,进入 Android sdk/platform-tools 目录 。 

@ 输入 adb shell, 进 入 Shell 模式 。 

®© 输入 getprop 命令 将 会 显示 系统 的 各 项 属性 ,其 中 包括 模拟 器 的 DNS 地 址 ,例如 : 


Microsoft Windows [版 本 6.1.7601] 

版 权 所 有 (c) 2009 Microsoft Corporation. 保留 所 有 权利 。 
D:\android- sdk- windows cd platform- tools 

D: Vandroid- sdk- windows platform - tools > adb shell 
root@generic_x86:/ # getprop 

getprop 


[net. bt. name]: [Android] 

[net. change]: [net. dns1] 

[net.dns1]: [10.0.2.3] 

[net. eth0.dns1]: [10. 0.2.3] 

[net.eth0.gw]: [10.0.2.2] 

[net.gprs.local- ip]: [10.0.2.15] 
[net.hostname]: [android - 91627a890f7bd0a5] 


可 以 发 现 ,在 对 两 个 模拟 器 进行 获取 时 ,IP 地 址 完全 一 样 ,都 是 10. 0. 2. 15. DNS 都 是 
10. 0. 2. 3, 所 以 要 实现 两 个 模拟 器 之 间 的 通信 ,使 用 模拟 器 的 IP 地 址 是 办 不 到 的 。 

注意 : net. eth0. gw 地 址 10.0.2. 2 等 同 于 PC 本 机 的 IP 地 址 127.0.0.1。 

(2) 设置 模拟 器 的 IP 

(D 进入 Shell 模式 。 

@ 输入 setprop net. dnsl 192. 168. 0. 1 , 即 可 把 DNS 修改 成 PC 的 DNS, 

@ 输入 setprop net. gprs. local-ip 192. 168. 0. 108 , 即 可 把 IP 地 址 修改 为 与 PC 在 一 个 
网 段 。 

这 样 模拟 器 的 IP 地 址 就 设置 完成 了 。 

(3) 重 定 向 模拟 器 (以 emulator-5554 作为 服务 端 ) 

O 启动 Windows 的 命令 行 窗 口 。 

@ 输入 telnet localhost 5554, 连 接 到 模拟 器 5554 ,显示 如 下 信息 : 


Trying ::1... 
Trying 127.0.0.1... 

Connected to localhost. 

Escape character is '^]'. 

Android Console: type 'help' for a list of commands 
OK 


© 成 功 连 接 后 ,继续 执行 “redir add tcp:5000:6000” 命 令 ,将 PC 端口 5000 绑 定 到 模拟 
器 5554 的 端口 6000 上 。 

此 时 模拟 器 5556 通过 向 PC 的 端口 5000( 即 地 址 10. 0. 2. 2:5000) 发 送 TCP/UDP 数 
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据 报 , 即 可 与 模拟 器 5554 通信 。 


4.4 UDP 编程 与 NIO 编程 


本 节 简 单 介绍 关于 UDP 编程 和 NIO 编程 的 基础 知识 。 
4.4.1 UDP 编程 


4.3 节 介 绍 的 Socket 编程 是 基于 TCP 协议 的 ,本 节 介 绍 使 用 UDP 实现 DatagramSocket 
编程 的 方法 。 

UDP( User Datagram Protocol, 用 户 数据 报 协议 ) 是 OSI 参考 模型 中 一 种 无 连接 的 传 
输 层 协议 ,提供 面向 事务 的 简单 不 可 靠 信息 传送 服务 。 在 网 络 中 它 与 TCP 协议 一 样 用 于 处 
理 数 据 报 。UDP 有 不 提供 数据 报 分 组 .组 装 和 不 能 对 数据 报 进行 排序 的 缺点 ,也 就 是 说 , 当 
报 文 发 送 之 后 ,是 无 法 得 知 其 是 否 安全 完整 到 达 的 。 

类 似 网 络 视频 会 议 系 统 等 众多 的 客户 /服务 器 模式 的 网 络 应 用 都 需要 使 用 UDP 协议 。 
UDP 协议 的 主要 作用 是 将 网 络 数据 流量 压缩 成 数据 报 的 形式 。 一 个 典型 的 数据 报 就 是 一 
个 二 进 制 数 据 的 传输 单位 。 每 一 个 数据 报 的 前 8 个 字 节 用 来 包含 报头 信息 ,剩余 字 节 则 用 
来 包含 具体 的 传输 数据 。 

实现 UDP 编程 的 方法 如 下 。 

1. 接收 方 编程 

接收 方 编程 的 一 般 步骤 如 下 。 

(D 创建 一 个 DatagramSocket 对 象 ,并 指定 监听 的 端口 号 。 

DatagramSocket 表示 接收 或 发 送 数据 报 的 套 接 字 ,位 于 java. net 包 中 。DatagramSocket 的 
构造 方法 有 以 下 几 种 。 

* DatagramSocket() : 通常 用 于 客户 端 编程 , 它 用 本 地 任何 一 个 可 用 的 端口 创建 一 个 套 

接 字 ,这 个 端口 号 是 由 系统 随机 产生 的 。 如 果 构 造 不 成 功 , 则 触发 SocketException 异 
常 。 使 用 方法 如 下 : 


01 try{ 

02 DatagramSocket datas = new DatagramSocket(); 
03 } catch(SocketException e) { 

04 ] 


* DatagramSocket(int port): 用 一 个 指定 的 端口 号 port 创建 一 个 套 接 字 。 

* DatagramSocket(int port, InetAddress localAddr): 当 一 台 设 备 拥 有 多 于 一 个 IP 
地 址 的 时 候 ,由 它 创 建 的 实例 仅仅 接收 来 自 LocalAddr 的 报 文 。 

DatagramSocket 提供 的 常用 方法 包括 以 下 几 个 。 

。 pubic void close); 关闭 DatagramSocket。 在 应 用 程序 退出 的 时 候 , 通 常会 主动 释 
放 资 源 ,关闭 Socket, 但 是 由 于 异常 退出 可 能 造成 资源 无 法 回收 。 所 以 ,应 该 在 程序 
完成 时 ,主动 使 用 此 方法 关闭 Socket, 或 在 捕获 到 异常 抛 出 后 关闭 Sock. 
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* public int getLocalPort(): 返回 本 地 套 接 字 正在 监听 的 端口 号 。 

。 public void receive (DatagramPacket p): 从 网 络 上 接收 数据 报 并 将 其 存储 在 
DatagramPacket 对 象 p P. p 中 的 数据 缓冲 区 必须 足够 大 ,receive() 把 尽 可 能 多 的 
数据 存放 在 p 中 ,如 果 装 不 下 ,就 把 其 余 的 部 分 丢弃 。 接 收 数据 出 错时 会 抛 出 
IOException 异常 。 

publicvoid Send (DatagramPacket p): 发 送 数据 报 , 出 错时 会 发 生 IOException 
异常 。 

* setSoTimeout(int timeout); 设置 超时 时 间 ,单位 为 毫秒 。 

Q 创建 一 个 byte 数组 用 于 接收 数据 。 如 : 


lbyte data[] = new byte[1024]; 


© 创建 一 个 空 的 DatagramPackage 对 象 。 
DatagramPackage 表示 存放 数据 的 数据 报 , 位 于 java. net 包 中 。DatagramPackage 主 
要 用 于 将 byte 数组 .目标 地 址 .目标 端口 等 数据 包装 成 报 文 或 者 将 报 文 拆 印 成 byte 
数组 。 
DatagramPackage 接收 数据 报 的 常用 构造 方法 有 两 种 : 
* DatagramPacket(byte ibuft[ ],int ilength) 
* DatagramPacket( byte ibuft[ ],int offset,int ilength) 
ibuf[] 为 接受 数据 报 的 存储 数据 的 缓冲 区 长 度 ,ilength 为 从 传递 过 来 的 数据 报 中 读 取 
的 字 节 数 。 当 采用 第 一 种 构造 方法 时 ,接收 到 的 数据 从 ibuftL0] 开 始 存 放 , 直 到 整个 数据 报 
接收 完毕 或 者 将 ilength 的 字 节 写 入 ibuft 为 止 。 采 用 第 二 种 构造 方法 时 ,接收 到 的 数据 从 
ibuftLoffsetj 开 始 存 放 。 如 果 数 据 报 长 度 超 出 了 ilength, 则 触发 IllegalArgument-Exception 
(该 异常 是 RuntimeException, 一 般 不 需要 用 户 单独 写 代码 捕获 它 ) 。 
DatagramPackage 发 送 数据 报 的 常用 构造 方法 有 两 种 : 
* DatagramPacket(byt ibuf[ ].int ilength, InetAddrss iaddr,int port) 
* public DatagramPacket(byt ibuf[ ].int offset, int ilength,InetAddrss iaddr,int port) 
iaddr 为 数据 报 要 传递 到 的 目标 地 址 ,port 为 目标 地 址 的 程序 接受 数据 报 的 端口 号 。 
ibuf[] 为 要 发 送 数据 的 存储 区 ,以 ibuf 数组 的 offset 位 置 开始 填充 数据 报 的 ilength 字 节 。 
如 果 没 有 offset, WM ibuf 数组 的 0 位 置 开 始 填充 。 
DatagramPackage 提供 的 常用 方法 包括 以 下 几 种 。 
* public InetAddress getAddressO : 如 果 是 发 送 数据 报 , 则 获得 数据 报 要 发 送 的 目标 
地 址 。 如 果 是 接收 数据 报 , 则 返回 发 送 此 数据 报 的 源 地 址 。 
* public byte[ ]getDataO : 返回 一 个 字 节 数组 ,内 容 是 数据 报 的 数据 。 
* public int getLengthO : 获得 数据 报 中 数据 的 字 节 数 。 
e pubic int getPortO ; 返回 数据 报 中 的 目标 地 址 的 主机 端口 号 。 
© 使 用 receive() 方 法 接收 发 送 方 所 发 送 的 数据 ,同时 这 也 是 一 个 阻塞 的 方法 。 
© 处 理发 送 过 来 的 数据 。 
下 面 的 代码 演示 了 处 理 接收 数据 的 全 部 流程 : 
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01 public void StartListen() { 


02 Integer port = 8903; 

03 byte[ ] message = new byte[100]; 

04 

05 try ( 

06 DatagramSocket datagramSocket = new DatagramSocket(port) ; 
07 datagramSocket. setBroadcast(true); 

08 DatagramPacket datagramPacket = new DatagramPacket(message, 
09 message. length); 

10 try { 

m while (!IsThreadDisable) { 

12 Log. d("UDP Demo", "准备 接收 "); 

13 this. lock. acquire(); 

14 

15. datagramSocket. receive(datagramPacket) ; 

16 String strMsg = new String(datagramPacket. getData()).trim(); 
17 Log. d("UDP Demo", datagramPacket. getAddress( ) 

18 . getHostAddress(). toString() 

19 + ":"  strMsg );this. lock. release() ; 
20 } 

21 } catch (IOException e) (//IOException 

22 e. printStackTrace( ) ; 

23 } 

24 } catch (SocketException e) { 

25 e. printStackTrace( ) ; 

26 } 

27 

28 ] 

2. 发 送 方 编程 


发 送 方 编程 的 一 般 步 又 如 下 : 

(D 创建 一 个 DatagramSocket 对 象 。 

© 创建 一 个 InetAddress, 表 示 数 据 报 的 目的 地 址 。 

@ 准备 发 送 数 据 ,并 将 数据 转换 为 byte 类 型 。 

@ 创建 一 个 DatagramPacket 对 象 ,并 指定 数据 报 发 送 的 目的 地 址 及 端口 号 。 
( 调用 DatagramSocket 对 象 的 send() 方 法 发 送 数据 。 

下 面 的 代码 演示 了 处 理发 送 数据 的 全 部 流程 : 


01 public void send(String message) { 


02 message = (message == null? "Hello Android!" : message); 
03 int server port - 8904; 

04 Log.d("UDP Demo", "UDP 发 送 数据 :" + message); 

05 DatagramSocket s - null; 

06 

07 tryí 

08 S = new DatagranSocket() ; 

09 } catch (SocketException e) { 
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10 e. printStackTrace(); 

11 } 

12 

13 InetAddress local = null; 

14 try { 

15 local = InetAddress. getByName("255. 255.255.255"); 
16 } catch (UnknownHostException e) { 

17 e. printStackTrace(); 

18 } 

19 

20 int msg length = message. length(); 

2 byte[] messageByte = message.getBytes(); 
22 DatagramPacket p = new DatagramPacket(messageByte, msg length, local, 
23 server port); 

24 

25 try { 

26 s.send(p) ; 

27 s.close(); 

28 } catch (IOException e) { 

29 e. printStackTrace( ) ; 

30 } 

EISE 


iE XE «Google 不 鼓励 在 手机 中 直接 接收 UDP 包 ( 手 机 开启 UDP 广播 功能 不 仅 耗 电 , 而 
且 占 用 系统 资源 ) ,因此 ,有 的 手机 厂商 在 定制 Rom 的 时 候 关 掉 了 这 个 功能 。 下 面 给 出 一 个 
解决 方案 。 

首先 在 Activity 的 onCreate() 方 法 里 实例 化 一 个 WifiManager. MulticastLock 对 象 
lock ,例如 : 


01 WifiManager manager = (WifiManager) 
02 this.getSystemService(Context.WIFI SERVICE); 
03 WifiManager.MulticastLock lock = manager.createMulticastLock(" wifi"); 


然后 在 调用 广播 发 送 、 接 收报 文 之 前 先 调用 lock. acquire() 方 法 ,调用 完 之 后 及 时 调用 
lock. release( ) 方 法 释放 资源 (多 次 调用 lock. acquire() 方 法 ,可 能 会 产生 java. lang. 
UnsupportedOperationException 异常 )。 

最 后 在 配置 文件 里 面 添 加 如 下 权限 : 


01 <uses— permission 
02 android:name = "android. permission. CHANGE WIFI MULTICAST STATE" /> 


经 过 以 上 处 理 后 ,多 数 手机 都 能 正常 发 送 和 接收 广播 报 文 。 
4.4.2 NIO 编程 


JDK 1. 4 中 引入 的 新 输入 输出 库 (New IO,NIO ,一 种 对 N 的 理解 是 Noblocking , 即 非 
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阻塞 的 意思 ) 在 标准 Java 代码 中 提供 了 高 速 的 、 面 向 块 的 1/O。 

在 使 用 Socket 进行 数据 交换 时 , 当 Socket 连接 建立 成 功 后 ,服务 端 和 客户 端 都 会 拥有 
一 个 Socket 实例 ,每 个 Socket 实例 都 有 一 个 InputStream 和 OutputStream, 正 是 通过 这 两 
个 对 象 来 交换 数据 。 当 Socket 对 象 创建 时 ,操作 系统 将 会 为 InputStream 和 OutputStream 
分 别 分 配 一 定 大 小 的 缓冲 区 ,数据 的 写 人 和 读 取 都 是 通过 这 个 缓存 区 完成 的 。 值 得 特别 注 
意 的 是 ,这 个 缓存 区 的 大 小 以 及 写 和 端的 速度 和 读 取 端的 速度 非常 影响 这 个 连接 的 数据 传 
输 效 率 , 如 果 两 边 同 时 传送 数据 时 可 能 会 产生 死 锁 。 

原来 的 IO 库 ( 在 java. io. * 中 ) 与 NIO 最 重要 的 区 别 是 数据 打包 和 传输 的 方式 。 原 
来 的 I/O 以 流 的 方式 处 理 数据 ,而 NIO 以 块 的 方式 处 理 数据 。 面 向 流 的 IO 系统 一 次 一 个 
字 节 地 处 理 数 据 。 一 个 输入 流产 生 一 个 字 节 的 数据 ,一 个 输出 流 消费 一 个 字 节 的 数据 。 面 
向 块 的 I/O 系统 以 块 的 形式 处 理 数 据 。 每 一 个 操作 都 在 一 步 中 产生 或 者 消费 一 个 数据 块 。 
按 块 处 理 数据 比 按 字 节 处 理 数 据 要 快 得 多 。 但 是 面向 块 的 IO 缺少 一 些 面向 流 的 L/O 所 
具有 的 优雅 性 和 简单 性 。 

1. NIO 的 核心 类 

(D ByteBuffer 

ByteBuffer 位 于 java. nio 包 中 , 目前 提供 了 Java 基本 类 型 中 除 Boolean 外 其 他 类 型 的 
缓冲 类 型 ,如 ByteBuffer, DoubleBuffer , FloatBuffer, IntBuffer, LongBuffer 和 ShortBuffer 
等 。 同 时 还 提供 了 一 种 更 特殊 的 映射 字 节 缓冲 类 型 MappedByteBuffer. 

使 用 ByteBuffer 类 的 静态 方法 static ByteBuffer allocate (int capacity) 或 static 
ByteBuffer allocateDirect(int capacity) 这 两 个 方法 来 分 配 内 存 空间 ,两 种 方法 的 区 别 主要 
是 后 者 更 适用 于 反复 分 配 的 字 节 数组 。 

ByteBuffer 可 以 很 好 地 和 字 节 数组 bytel ] 进 行 转换 类 型 ,通过 执行 ByteBuffer 类 的 
final byte[] array() 方 法 就 可 以 将 ByteBuffer 转 为 byte[ ]。 从 byte[ ] 来 构造 ByteBuffer 可 
以 使 用 wrap 方法 ,目前 Android 提供 了 两 种 重 载 方 法 ,如 static ByteBuffer wrap(byte[ ] 
array) 和 static ByteBuffer wrap(byte[ ] array, int start, int len) 。 第 二 个 重 载 方法 中 第 二 
个 参数 为 array 字 节 数组 的 起 初 位 置 , 第 三 个 参数 为 array 字 节 数组 的 长 度 。 

ByteBuffer 提供 了 多 种 put/get 方法 类 型 来 添加 /获取 数据 元 素 , 如 put (byte b), 
getDouble(int index) 等 。 需 要 注意 的 是 ,按照 Java 的 类 型 长 度 ,一 个 byte ii 1 字 节 ,一 个 
char 类 型 是 2 字 节 ,一 个 float 或 int 是 4 字 节 ,一 个 long WA 8 字 节 ,所 以 内 部 的 相关 位 置 
也 会 发 生变 化 ,同时 每 种 方法 还 提供 了 定位 的 方法 ,如 ByteBuffer put(int index, byte b). 

(2) FileChannel 

Channel 是 一 个 对 象 ,可 以 通过 它 读 取 和 写 入 数据 。 在 NIO 中 ,除了 Socket 外 ,还 提供 
T File 设备 的 通道 类 ,FileChannel 位 于 java. nio. channels. FileChannel 包 中 。 

通道 与 流 的 不 同 之 处 在 于 通道 是 双向 的 。 而 流 只 是 在 一 个 方向 上 移动 (一 个 流 必须 是 
InputStream 或 者 OutputStream 的 子 类 ) ,而 通道 可 以 用 于 读 、 写 或 者 同时 用 于 读 写 。 

下 面 的 代码 演示 了 FileChannel 的 使 用 。 

01 String infile = "/sdcard/cwj.dat"; 


02 String outfile = "/sdcard/test. dat”; 
03 
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04 FileInputStream fin = new FileInputStream( infile ); 

05 FileOutputStream fout = new FileOutputStream( outfile ); 
06 

07 FileChannel fcin = fin.getChannel(); 

08 FileChannel fcout - fout.getChannel(); 


10 ByteBuffer buffer = ByteBuffer.allocate( 1024 ); //4} fc 1KB 作为 缓冲 区 


12 while (true) ( 
13 buffer.clear(); // 每 次 使 用 必须 置 空 缓冲 区 


14 

15 intr = fcin. read( buffer ); 
16 

17 if (r== -1){ 

18 break; 

19 } 

20 

21 buffer. flip(); 

22 

23 fcout.write( buffer ); 
24 } 


flipO fll clear() 这 两 个 方法 是 java. nio. Buffer 类 中 的 方法 ,ByteBuffer 的 父 类 是 从 
Buffer 类 继承 而 来 的 。 

(3) SocketChannel 与 ServerSocketChannel 

在 Java 的 New I/O 中 ,处 理 Socket 通信 的 是 SocketChannel,SocketChannel 关联 了 一 
个 Socket 类 ,使 用 SocketChannel 类 的 socket() 方 法 可 以 返回 一 个 传统 I/O 的 Socket 类 。 
SocketChannel() 对 象 在 Server 中 一 般 通 过 Socket 类 的 getChannel() 方 法 获得 。 

处 理 ServerSocket 通信 的 是 ServerSocketChannel ,通过 ServerSocketChannel 类 的 socket() 
方法 可 以 获得 一 个 传统 的 ServerSocket 对 象 ,同时 从 ServerSocket 对 象 的 getChannel() 77 
法 可 以 获得 一 个 ServerSocketChannel() 对 象 ,这 点 说 明 NIO 的 ServerSocketChannel 和 传 
统 IO 的 ServerSocket 是 有 关联 的 ,实例 化 ServerSocketChannel 只 需要 直接 调用 
ServerSocketChannel 类 的 静态 方法 open() 即 可 。 

(4) Selector 

New I/O 中 的 核心 对 象 名 为 Selector, Selector 就 是 注册 对 各 种 1/0 事件 感 兴趣 的 地 
方 ,而 且 当 那些 事件 发 生 时 ,就 是 由 这 个 对 象 来 反映 所 发 生 的 事件 。 

调用 Selector 的 静态 工厂 创建 一 个 选择 器 ,创建 一 个 服务 端的 Channel 并 绑 定 到 一 个 
Socket 对 象 ,再 把 这 个 通信 信道 注册 到 选择 器 上 ,同时 把 这 个 通信 信道 设置 为 非 阻 塞 模式 。 
然后 就 可 以 调用 Selector 的 selectedKeys() 方 法 来 检查 已 经 注册 到 这 个 选择 器 上 的 所 有 通 
信 信 道 是 否 有 需要 的 事件 发 生 , 如果 有 某 个 事件 发 生 时 ,将 会 返回 所 有 的 SelectionKey, 通 
过 这 个 对 象 Channel 方法 就 可 以 取得 这 个 通信 信道 对 象 ,从 而 可 以 读 取 通 信 的 数据 ,而 这 里 
读 取 的 数据 是 Buffer。 例 如 : 
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01 public void selector() throws IOException { 


02 
03 
04 
05 


ByteBuffer buffer = ByteBuffer.allocate(1024); 
Selector selector = Selector. open(); 
ServerSocketChannel ssc = ServerSocketChannel.open(); 


ssc. configureBlocking(false); // 设 置 为 非 阻塞 方式 
ssc. socket(). bind(new InetSocketAddress(8080)); 
ssc. register(selector, SelectionKey.OP ACCEPT); // 注 册 监 听 的 事件 
while (true) { 

Set selectedKeys = selector. selectedKeys() ; // 取 得 所 有 key RA 


Iterator it = selectedKeys. iterator(); 
while (it.hasNext()) ( 
SelectionKey key = (SelectionKey) it.next(); 
if ((key.readyOps() & SelectionKey.OP ACCEPT) -- 
SelectionKey.OP ACCEPT) { 
ServerSocketChannel ssChannel - 
(ServerSocketChannel) key.channel(); 
SocketChannel sc = ssChannel.accept(); // 接 收 到 服务 端的 请 求 
sc. configureBlocking(false); 
sc. register(selector, SelectionKey. OP_READ) ; 
it. remove() ; 
} else if ((key. readyOps() & SelectionKey.OP READ) == 
SelectionKey.OP READ) { 
SocketChannel sc = (SocketChannel) key.channel(); 
while (true) ( 
buffer.clear(); 
int n = sc.read(buffer); // 读 取 数 据 
if (n<= 0) { 
break; 
} 
buffer. flip(); 
} 


it. remove(); 


在 上 面 的 这 段 程序 中 ,是 将 Server 端的 监听 连接 请 求 的 事件 和 处 理 请 求 的 事件 放 在 一 
个 线程 中 ,但 是 在 实际 应 用 中 ,通常 会 把 它们 放 在 两 个 线程 中 ,一 个 线程 专门 负责 监听 客户 
端的 连接 请 求 ,而 且 是 阻塞 方式 执行 的 ; 另外 一 个 线程 专门 来 处 理 请 求 ,这 个 专门 处 理 请 求 
的 线程 才 会 真正 采用 NIO 的 方式 。 

2. 实现 NIO 编程 

一 般 来 说 ,很 少 在 Android 客户 端 实现 NIO 编程 ,毕竟 NIO 相对 于 BIO 在 逻辑 处 理 上 
要 复杂 得 多 。 下 面 介绍 在 Android 平台 上 实现 一 个 非 阻 塞 的 服务 器 的 开发 过 程 。 

基本 步骤 如 下 : 

(D 通过 Selector 类 的 open() 静 态 方法 实例 化 一 个 Selector 对 象 。 

© 通过 ServerSocketChannel 类 的 open() 静 态 方法 实例 化 一 个 ServerSocketChannel 
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对 象 。 

© 显 式 地 调用 ServerSocketChannel 对 象 的 configureBlocking(false) 方 法 ,并 设置 为 
非 阻塞 模式 。 

@ 使 用 ServerSocketChannel 对 象 的 socket() 方 法 返回 一 个 ServerSocket 对 象 ,使 用 
ServerSocket 对 象 的 bind() 方 法 绑 定 一 个 IP 地 址 和 端口 号 。 

© 调用 ServerSocketChannel 对 象 的 register() 方 法 注册 相关 的 网 络 事件 。 

© 通过 Selector 对 象 的 select() 方 法 判断 是 否 有 关注 的 事件 发 生 。 

D 如 果 Selector 对 象 的 select() 方 法 返回 的 结果 数 大 于 0, 则 通过 Selector 对 象 的 
selectedKeys() 方 法 获取 一 个 SelectionKey 类 型 的 Set 集合 ,使 用 Java 的 迭代 器 Iterator 类 
来 遍历 这 个 Set 集合 (注意 判断 SelectionKey 对 象 ) 。 

处 理 完 SelectionKey 对 象 后 需要 从 Set 集合 中 移 除 。 

© 接 下 来 判断 SelectionKey 对 象 的 事件 ,使 用 SelectionKey 对 象 的 isAcceptable() 方 
法 进行 判断 。 

下 面 的 connect() 方 法 演示 了 上 述 过 程 。 


01 public void connect() { 


02 Selector selector = null; 

03 ServerSocketChannel ssc - null; 

04 

05 try { 

06 selector = Selector. open() ; 

07 ssc = ServerSocketChannel. open() ; 

08 ssc. socket(). bind(new InetSocketAddress(1988)); 

09 ssc. configureBlocking(false); 

10 ssc.register(selector, SelectionKey.OP ACCEPT); 

ABL 

12 while (true) ( 

13 intn = selector.select(); 

14 if (n«1) 

35 continue; 

16 Iterator <SelectionKey> it = selector. selectedKeys(). iterator(); 
ibl while (it. hasNext()) { 

18 SelectionKey key = it.next(); 

19 it. remove() ; 

20 

£g if (key. isAcceptable()) ( 

22 ServerSocketChannel ssc2 - (ServerSocketChannel) key 
23 .channel(); 

24 SocketChannel channel = ssc2.accept(); 

25 channel. configureBlocking( false) ; 

26 channel. register(selector, SelectionKey.OP READ); 

27 

28 Log.i("CWJ Client :", channel. socket().getInetAddress() 
29 .getHostName() + ":" + channel. socket().getPort()); 
30 } 

31 
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32 else if (key. isReadable()) { 

33) SocketChannel channel = (SocketChannel) key. channel() ; 
34 ByteBuffer buffer = ByteBuffer. allocate(1024) ; 

35 channel. read( buffer) ; 

36 buffer. flip(); 

37 Log. i("receive info:", buffer. toString()); 

38 channel. write(CharBuffer. wrap("it works". getBytes())); 
39 } 

40 } 

41 j 

42 } catch (IOException e) { 

43 e. printStackTrace( ) ; 

44 ) finally ( 

45 try { 

46 selector. close(); 

47 server. close(); 

48 } catch (IOException e) { 

49 } 

50 } 

pu. y 


上 面 的 方法 在 单 次 交互 以 及 数据 量 较 小 时 一 般 没有 太 大 问题 ,但 是 对 于 多 次 交互 及 数 
据 量 大 时 ,也 可 能 发 生 阻 塞 。 例 如 ,在 判断 key. isReadable() 时 ,对 于 这 个 SelectionKey X 
联 的 SocketChannel, 尽 量 不 要 在 写 人 数据 量 过 多 时 ,让 ByteBuffer 调用 hasRemaining() 这 
样 的 方法 。 读 者 可 以 仔细 阅读 资源 包 中 的 SocketUtil 以 了 解 健壮 性 更 强 的 NIO 方法 。 


4.5 7 题 


1. 完善 4. 3 节 Socket 编程 的 示例 ,实现 Socket 与 ServerSocket 之 间 的 相互 通信 。 
2. 使 用 UPD 编程 实现 手机 和 计算 机 之 间 的 相互 通信 。 
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大 多 数 网 络 连接 的 Android 应 用 使 用 HTTP 发 送 和 接收 数据 , Android 包括 两 个 
HTTP 客户 端 HttpURLConnection 和 Apache HttpClient, 它们 支持 HTTPS、 流 的 上 传 
和 下 载 ,可 配置 IPv6 以 及 连接 池 。 


5.1 HTTP 协议 与 URL 


本 节 介绍 关于 HTTP 协议 的 基础 知识 ,以 及 URL 的 组 成 。 
5.1.1 HTTP 协议 


HTTP(HyperText Transfer Protocol, 超 文本 传输 协议 ) 是 一 个 基于 请 求 与 响应 模式 
的 无 状态 的 应 用 层 协议 ,通常 基于 TCP 的 连接 方式 。 

1. HTTP 协议 的 特点 与 分 类 

HTTP 协议 的 主要 特点 如 下 。 

。 支持 客户 /服务 器 模式 。 

。 简单 快速 : 客户 向 服务 器 请 求 服务 时 ,只 需 传送 请 求 方法 和 路 径 。 

。 灵活: HTTP 允许 传输 任意 类 型 的 数据 对 象 (类 型 由 Content-Type 加 以 标记 )。 

。 无 连接: 即 每 次 连接 只 处 理 一 个 请 求 ,处 理 完 客户 的 请 求 , 并 收 到 客户 的 应 答 后 , 即 
断 开 连 接 。 采 用 这 种 方式 可 以 节省 传输 时 间 。 

* 无 状态 : 无 状态 是 指 协议 对 于 事务 处 理 没 有 记忆 能 力 。 

HTTP 协议 包括 以 下 两 种 。 

* HTTP 1.0 协议 : 客户 端 在 每 次 向 服务 器 发 出 请 求 后 ,服务 器 就 会 向 客户 端 返回 响 
应 消息 (包括 请 求 是 否 正确 以 及 所 请 求 的 数据 ), 在 确认 客户 端 已 经 收 到 响应 消息 
后 ,服务 端 就 会 关闭 网 络 连接 ( 即 关闭 TCP 连接 )。 在 这 个 数据 传输 过 程 中 ,并 不 保 
存 任何 历史 信息 和 状态 信息 ,因此 ,HTTP 1.0 协议 也 被 认为 是 无 状态 的 协议 。 

。 HTTP 1.1 协议 : 当 客 户 端 连 接 到 服务 器 后 ,服务 器 就 将 关闭 客户 端 连接 的 主动 权 
交还 给 客户 端 。 也 就 是 说 ,在 客户 端 向 服务 器 发 送 一 个 请 求 并 接收 一 个 响应 后 ,只 
要 不 调用 类 似 Socket 类 的 close() 方 法 关闭 网 络 连接 ,就 可 以 继续 向 服务 器 发 送 
HTTP 请 求 。 并 且 同 一 对 客户 /服务 器 之 间 的 后 续 请 求 和 响应 都 可 以 通过 这 个 连接 
发 送 , 这 样 就 可 以 大 大 减轻 服务 器 的 压力 。 

2. HTTP 请 求 /响应 的 组 成 

HTTP 消息 由 客户 端 到 服务 器 的 请 求 和 服务 器 到 客户 端的 响应 组 成 。 请 求 消息 和 响 


第 5 章 HTTP 编程 
应 消息 都 是 由 开始 行 (对 于 请 求 消息 ,开始 行 就 是 请 求 行 ; 对 于 响应 消息 ,开始 行 就 是 状态 
行 )、 消 息 报头 (可 选 ) 、 空 行 ( 只 有 CRLF 的 行 )、 消 息 正文 (可 选 ) 组 成 。 
(1) 请 求 行 
请 求 行 以 一 个 方法 符号 开头 ,以 空格 分 开 , 后 面 跟 着 请 求 的 URI 和 协议 的 版 本 ,格式 如 下 : 





Method Request - URI HTTP - Version CRLF 


其 中 Method 表示 请 求 方法 ; Request-URI 是 一 个 统一 资源 标识 符 ; HTTP-Version X 
示 请 求 的 HTTP 协议 版 本 ; CRLF 表示 回 车 和 换行 (除了 作为 结尾 的 CRLF 外 ,不 允许 出 
现 单独 的 CR 或 LF 字符 ) 。 


请 求 方法 (所 有 方法 全 为 大 写 ) 解 释 如 表 5-1 所 示 。 
表 5-1 HTTP 的 请 求 方法 





























请 求 方法 说 明 

GET 请 求 获取 Request-URI 所 标识 的 资源 

POST 在 Request-URI 所 标识 的 资源 后 附加 新 的 数据 

HEAD 请 求 获取 由 Request-URI 所 标识 的 资源 的 响应 消息 报头 

PUT 请 求 服务 器 存储 一 个 资源 ,并 用 Request-URI 作为 其 标识 

DELETE 请 求 服务 器 删除 Request-URI 所 标识 的 资源 

TRACE 请 求 服务 器 回 送 收 到 的 请 求 信 息 , 主 要 用 于 测试 或 诊断 

CONNECT 保留 将 来 使 用 

OPTIONS 请 求 查询 服务 器 的 性 能 ,或 者 查询 与 资源 相关 的 选项 和 需求 
(2) 状态 行 


状态 行 包括 HTTP 协议 版 本 号 ,状态 码 、 状 态 码 的 文本 描述 信息 。 如 : HTTP/1. 1 
200 OK. 

状态 码 由 一 个 三 位 数组 成 ,状态 码 大 体 有 5 种 含义 。 

。 1xx: 信息 ,请 求 收 到 ,继续 处 理 。 

。 2xx: 成 功 。200 表示 请 求 成 功 ; 206 表示 断 点 续 传 。 

* 3xx: 重 定向 。 一 般 跳 转 到 新 的 地 址 。 

。 4xx: 客户 端 错误 。404 表示 文件 不 存在 。 

。 5xx: 服务 器 错误 。500 表示 内 部 错误 。 

(3) 消息 报头 

HTTP 消息 报头 包括 普通 报头 、 请 求 报头 响应 报头 、 实 体 报头 。 每 一 个 报头 域 都 是 由 
“名 字 十 ': ' 十 空格 十 值 ?组 成 的 ,消息 报头 域 的 名 字 与 大 小 写 无 关 。 

O 请 求 报头 

请 求 报头 允许 客户 端 向 服务 器 端 传递 请 求 的 附加 信息 以 及 客户 端 自身 的 信息 。 

常用 的 请 求 报头 包括 以 下 几 种 。 

。 Accept: 请 求 报头 域 用 于 指定 客户 端 接收 哪些 类 型 的 信息 。 

。 Accept-Charset: 请 求 报头 域 用 于 指定 客户 端 接收 的 字符 集 。 

。 Accept-Encoding: 请 求 报头 域 类 似 于 Accept, 但 是 它 是 用 于 指定 可 接收 的 内 容 
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编码 。 

Accept-Language: 请 求 报头 域 类 似 于 Accept, 但 是 它 是 用 于 指定 一 种 自然 语言 。 
Authorization: 请 求 报头 域 主要 用 于 证 明 客 户 端 有 权 查 看 某 个 资源 。 

Host; 请 求 报头 域 主要 用 于 指定 被 请 求 资源 的 Internet 主机 和 端口 号 , 它 通常 从 
HTTP URL 中 提取 出 来 。 

User-Agent: 请 求 报头 域 允许 客户 端 将 它 的 操作 系统 、 浏 览 器 和 其 他 属性 告诉 服 
务 器 。 


@ 响应 报头 

响应 报头 允许 服务 器 传递 不 能 放 在 状态 行 中 的 附加 响应 信息 ,以 及 关于 服务 器 的 信息 
和 对 Request-URI 所 标识 的 资源 进行 下 一 步 访 问 的 信息 。 

常用 的 响应 报头 包括 以 下 几 种 。 


Location; 响应 报头 域 用 于 重 定向 接收 者 到 一 个 新 的 位 置 。Location 响应 报头 域 常 
用 在 更 换 域 名 的 时 候 。 
Server: 响应 报头 域 包 含 了 服务 器 用 来 处 理 请 求 的 软件 信息 。 


@ 实体 报头 
请 求 和 响应 消息 都 可 以 传送 一 个 实体 。 
常用 的 实体 报头 包括 以 下 几 种 。 


Content-Encoding: 指示 已 经 被 应 用 到 实体 正文 的 附加 内 容 的 编码 。 
Content-Language: 实体 报头 域 描述 了 资源 所 用 的 自然 语言 。 

Content-Length: 实体 报头 域 用 于 指明 实体 正文 的 长 度 , 以 字 节 方式 存储 的 十 进 制 
数字 来 表示 。 

Content-Type; 实体 报头 域 用 于 指明 发 送 给 接收 者 的 实体 正文 的 媒体 类 型 。 
Last-Modified: 实体 报头 域 用 于 指示 资源 的 最 后 修改 日 期 和 时 间 。 

Expires: 实体 报头 域 给 出 响应 过 期 的 日 期 和 时 间 。 


5.1.2 URL 


URL(Uniform Resource Locator) 代 表 一 个 统一 资源 定位 符 , 它 是 指向 互联 网 “资源 ” 
的 指针 。 资 源 可 以 是 简单 的 文件 或 目录 ,也 可 以 是 对 更 为 复杂 的 对 象 的 引用 ,例如 对 数据 库 
或 搜索 引擎 的 查询 。 
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URL 的 组 成 


URL 一 般 包 含 协议 .主机 名 、 端 口 路径、 查询 字符 串 和 参数 等 对 象 。URL 的 格式 如 下 : 


protocol://host:[port]/path/[parameters] [?query] 


protocol( Hi): 最 常用 的 是 HTTP 协议 , 它 也 是 目前 WWW 中 应 用 最 广 的 协议 ， 
格式 为 “http://”。ftp 通过 FTP 访问 资源 ,格式 为 “ftp://”。mailto 资源 为 电子 邮 
件 地 址 ,通过 SMTP 访问 ,格式 为 “mailto://”。 

hostname( 主 机 名 ): 是 指 存放 资源 的 服务 器 的 域名 系统 (DNS) 主 机 名 或 IP 地 址 。 
port( 端 口号 ) : 整数 ,可 选 ,省 略 时 使 用 方案 的 默认 端口 ,各 种 传输 协议 都 有 默认 的 
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端口 号 ,如 http 的 默认 端口 为 80。 
。 path( 路 径 ): 由 零 或 多 个 /符号 隔 开 的 字符 串 ,一 般 用 来 表示 主机 上 的 一 个 目录 或 
文件 地 址 。 
。 parameters: 资源 名 称 等 参数 。 
* 2 query( 查 询 ) : 用 于 给 动态 网 页 传递 参数 ,可 有 多 个 参数 ,用 “&” 符 号 隔 开 ,每 个 参 
数 的 名 和 值 用 “二 ”符号 隔 开 。 
例如 ,http://www. oracle. com/index. html 表示 该 URL 使 用 的 协议 为 http( 超 文本 传 
输 协议 ) ,并 且 该 信息 驻 留 在 一 台 名 为 www. oracle. com 的 主机 上 。 主 机 上 的 信息 名 称 为 “/ 
index. html”, 这 一 部 分 称 为 路 径 部 分 。 
应 用 程序 也 可 以 指定 一 个 “相对 URL”, 它 只 包含 到 达 相 对 于 另 一 个 URL 的 资源 的 足 
够 信息 。HTML 页 面 中 经 常 使 用 相对 URL。 相 对 URL 不 需要 指定 URL 的 所 有 组 成 部 
分 。 如 果 缺 少 协 议 .主机 名 称 或 端口 号 ,这 些 值 将 从 完整 指定 的 URL 中 继承 。 例 如 ,faq. 
html Ey http://www. oracle. com/faq. html 的 缩写 。 
下 面 的 代码 演示 了 Java 所 支持 的 URL 类 型 


01 public void supportProtocal() ( 


02 

03 String host = "www. google. com"; 

04 String file = "/index. html"; 

05 

06 String[] schemes = {"http", "https", "ftp", "mailto", "telnet", "file", 
07 "ldap", "gopher", "jdbc", "rmi", "jndi", "jar", "doc", "netdoc", 
08 "nfs", "verbatin", "finger", "daytime", "systemresource"]; 

09 

10 for (int i = 0; i< schemes. length; i++) { 

11 try { 

12 URL u = new URL(schemes, host, file); 

13 Log. i("supportProtocal", schemes + " is supported/r/n") ; 

14 } catch (Exception ex) { 

15 Log. i("supportProtocal", schemes + " is not supported/r/n") ; 
16 } 

17 i 

a } 


下 面 介 绍 URL 的 编码 与 解码 。 
当 URL 地 址 里 包含 非 西欧 字符 的 字符 串 时 , URL. 并 不 自动 执行 编码 或 解码 工作 。 
java. net 包 中 的 URLEncoder 和 URLDecoder 类 提供 了 编码 与 解码 的 方法 ,如 下 所 示 o 

e encode(String s. String enc): 使 用 指定 的 编码 机 制 将 字符 串 转换 为 application/x- 
www-form-urlencoded 格式 。 

* decode(String s, String enc); 使 用 指定 的 编码 机 制 对 application/x-www-form- 
urlencoded 字符 串 解 码 。 

2. 主要 方法 

URL 包含 的 主要 方法 包括 以 下 几 种 。 
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URL(String spec): 根据 String 表示 形式 创建 URL MA. ARM URL MAM ,必须 
要 用 try-catch 语句 进行 MalformedURLException 例外 捕获 。 

URL(String protocol, String host, int port, String file) : 根据 指定 protocol, host, 
port 和 file 创建 URL #4. URL 提供 了 getProtocolO ,getHostO ,getPortO 等 方 
法 来 获取 URL 的 组 成 部 分 。 

openConnection(): 返回 一 个 URLConnection 对 象 , 它 表 示 到 URL 所 引用 的 远程 
对 象 的 连接 。 每 次 调用 openConnection() 方 法 都 打开 一 个 新 的 连接 。 如 果 URL 的 
协议 (例如 HTTP 或 JARO 存在 属于 以 下 包 或 其 子 包 之 一 的 公共 、 专 用 
URLConnection 子 类 (包括 java. lang .java. io java. util java. net) ,返回 的 连接 将 为 
该 子 类 的 类 型 。 例 如 ,对 于 HTTP, 将 返回 HttpURLConnection; 对 于 JAR ,将 返 
回 JarURLConnection。 

openConnection(Proxy proxy): 与 openConnection() 类 似 , 所 不 同 的 是 连接 通过 指 
定 的 代理 建立 ; 不 支持 代理 方式 的 协议 处 理 程 序 将 忽略 该 代理 参数 并 建立 正常 的 
连接 。 

openStream(): 打开 到 此 URL 的 连接 并 返回 一 个 用 于 从 该 连接 读 入 的 InputStream, 
setURLStreamHandlerFactory(URLStreamHandlerFactory fac): 设置 应 用 程序 的 
URLStreamHandlerFactory。 在 一 个 给 定 的 Java 虚拟 机 中 ,此 方法 最 多 只 能 调用 
一 次 。URLStreamHandlerFactory 实例 用 于 从 协议 名 称 构造 流 协议 处 理 程序 。 如 
果 有 安全 管理 器 ,此 方法 首先 调用 安全 管理 器 的 checkSetFactory 方法 以 确保 允许 
该 操作 。 这 可 能 会 导致 SecurityException 异常 。 

toStringO : 构造 此 URL 的 字符 串 表 示 形 式 。 

toURIO : 返回 与 此 URL 等 效 的 URI。 此 方法 的 作用 与 new URI (this. toString()) 相 
同 。 注 意 , 任 何 URL 实例 只 要 遵守 RFC 2396 就 可 以 转化 为 URI。 但 是 ,有 些 未 严 
格 遵守 该 规则 的 URL 将 无 法 转化 为 URI。 


使 用 java. io 流 处 理 类 从 URL 中 读 取 数据 是 一 个 非常 简单 的 过 程 。 一 旦 建立 了 一 个 成 
功 的 连接 ,就 可 以 获得 针对 这 个 连接 的 输入 流 并 且 开 始 进行 读 操作 。 下 面 的 示例 展示 了 如 
何 从 URL 中 读 取 文 本 数据 。 


01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 


public void readTxt(String url) { 
try { 
URL url = new URL( url); 
InputStream is = url. openStream() ; 
InputStreamReader isr = new InputStreamReader(is); 
BufferedReader bf = new BufferedReader(isr); 
String str; 


while ((str = bf. readLine()) != null) { 
Log. i(TAG, str); 
} 
} catch (MalformedURLException e) { 
e. printStackTrace( ) ; 
} catch (IOException e) { 
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15 e. printStackTrace(); 
16 ) 


5.2 HttpURLConnection 编程 


java. net. HttpURLConnection 类 是 继承 自 URLConnection (抽象 类 URLConnection 
是 所 有 类 的 超 类 , 它 代表 应 用 程序 和 URL 之 间 的 通信 连接 。 此 类 的 实例 可 用 于 读 取 和 写 
和 此 URL 引用 的 资源 。) 的 一 个 抽象 类 ,是 一 种 多 用 途 、 轻 量 极 的 HTTP 客户 端 ,使 用 它 来 
进行 HTTP 操作 可 以 适用 于 大 多 数 的 应 用 程序 。 


5.2.1 创建 HttpURLConnection 连接 


通常 创建 一 个 和 URL 的 连接 ,并 发 送 请 求 . 读 取 此 URL 引用 的 资源 需要 如 下 几 个 
步骤 : 

(D 通过 URL 对 象 的 openConnection() 方 法 来 创建 URLConnection 对 象 。 

Q) 设置 URLConnection 的 参数 和 普通 请 求 属性 。 

© 如 果 是 发 送 GET 方式 的 请 求 ,使 用 connect() 方 法 建立 和 远程 资源 之 间 的 实际 连接 
即 可 ; 如 果 需 要 发 送 POST 方式 的 请 求 ,需要 获取 URLConnection 实例 对 应 的 输出 流 来 发 
送 请 求 参 数 。 

@ 远程 资源 变 为 可 用 ,程序 可 以 访问 远程 资源 的 头 字段 ,或 通过 输入 流 来 读 取 远 程 资 
源 的 数据 。 

1. 创建 HttpURLConnection 对 象 

HttpURLConnection 是 一 种 访问 HTTP 资源 的 方式 ,在 HTTP 编程 时 ,来 自 
HttpURLConnection 的 类 是 所 有 操作 的 基础 。 

HttpURLConnection 是 一 个 抽象 类 ,不 能 通过 new HttpURLConnection() 的 方式 来 
获取 一 个 HttpURLConnection 对 象 。 常 见 的 做 法 是 使 用 java. net. URL 封装 HTTP 资源 
的 URL, 并 使 用 openConnection() 方 法 获得 HttpURLConnection 对 象 ,例如 : 


01 try{ 

02 URL url = new URL(httpUrl); 

03 URLConnection urlConnection = url.openConnection(); 

04 HttpURLConnection httpUrlConnection = (HttpURLConnection) urlConnection; 
05 } catch (MalformedURLException e) { 

06 e. printStackTrace(); 

07 } catch (IOException e) { 

os e. printStackTrace( ) ; 

09 } 


2. i$ € HttpURLConnection 参数 
HttpURLConnection API 提供 了 一 系列 的 set 方法 来 设置 网 络 连接 的 参数 ,主要 有 以 
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void setConnectTimeout(int timeout): 设置 一 个 指定 的 超时 值 (以 毫秒 为 单位 ) ,该 
值 将 在 打开 到 此 URLConnection 引用 的 资源 的 通信 连接 时 使 用 。 如 果 在 建立 连接 
之 前 超时 期 满 , 则 会 引发 一 个 java. net. SocketTimeoutException。 超 时 时 间 为 0 表 
示 无 穷 大 超时 。 

void setRequestMethod ( String method); 设置 URL 请 求 的 方法 ,包括 GET, 
POST, HEAD, OPTIONS, PUT, DELETE 和 TRACE, 具体 取决 于 协议 的 限制 。 
默认 方法 为 GET。 如 果 无 法 重 置 方法 或 者 请 求 的 方法 对 HTTP 无 效 , 则 抛 出 
ProtocolException 异常 。 

void setDoInput(boolean doinput): 将 此 URLConnection 的 doInput 字段 的 值 设 置 
为 指定 的 值 。URL 连接 可 用 于 输入 或 输出 。 如 果 打 算 使 用 URL 连接 进行 输入 , 则 
将 DoInput 标志 设置 为 true; 如 果 不 打算 使 用 , 则 设置 为 false。 默 认 值 为 true, 
void setDoOutput(boolean dooutput) : 将 此 URLConnection 的 doOutput 字段 的 值 
设置 为 指定 的 值 。 如 果 打 算 使 用 URL 连接 进行 输出 , 则 将 DoOutput 标志 设置 为 
true; 如 果 不 打 算 使 用 , 则 设置 为 false。 默 认 值 为 false。 

void setDefaultUseCaches( boolean defaultusecaches) : 将 useCaches 字段 的 默认 值 
设置 为 指定 的 值 。 

void setUseCaches(boolean usecaches) : 将 此 URLConnection 的 useCaches 字段 的 
值 设置 为 指定 的 值 。 有 些 协议 用 于 文档 缓存 。 有 时 候 能 够 进行 “直通 ”并 忽略 缓存 
尤其 重要 ,例如 浏览 器 中 的 “重新 加 载 ” 按 钮 。 如 果 连 接 中 的 UseCaches 标志 
true, 则 允许 连接 使 用 任何 可 用 的 缓存 ; 如 果 为 false, 则 忽略 缓存 ;默认 值 来 自 
DefaultUseCaches ,默认 为 true。 

void setRequestProperty(String key, String value): 设置 一 般 请 求 属性 。key 用 于 
识别 请 求 的 关键 字 ( 例 如 "Content-type")。value 表示 与 该 键 关 联 的 值 ( 例 如 " 
application/x-java-serialized-object")。HTTP 要 求 所 有 能 够 合法 拥有 多 个 具有 相 
同 键 的 实例 的 请 求 属 性 ,使 用 以 逗号 分 隔 的 列表 语法 ,这样 可 将 多 个 属性 添加 到 一 
个 属性 中 。 

static void setContentHandlerFactory(ContentHandlerFactory fac) : 设置 应 用 程序 
的 ContentHandlerFactory。 一 个 应 用 程序 最 多 只 能 调用 一 次 该 方法 。 
ContentHandlerFactory 实例 用 于 根据 内 容 类 型 构造 内 容 处 理 程序 。 如 果 有 安全 管 
理 器 ,此 方法 首先 调用 安全 管理 器 的 checkSetFactory 方法 以 确保 允许 该 操作 。 这 
可 能 会 导致 SecurityException 异常 。 

static void setDefaultAllowUserInteraction ( boolean defaultallowuserinteraction) : 
将 未 来 所 有 URLConnection 对 象 的 allowUserInteraction 字段 默认 值 设置 为 指定 
的 值 。 

void setChunkedStreamingMode(int chunklen) : 此 方法 用 于 在 预先 不 知道 内 容 长 
度 时 启用 没有 进行 内 部 缓冲 的 HTTP 请 求 正文 的 流 。 在 此 模式 下 ,使 用 存储 块 传 
输 编 码 发 送 请 求 正 文 。 注 意 , 并 非 所 有 HTTP 服务 器 都 支持 此 模式 。 启 用 输出 流 
时 ,不 能 自动 处 理 验证 和 重 定向 。 如 果 需 要 验证 和 重 定向 , 则 在 读 取 响 应 时 将 抛 出 
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HttpRetryException。 可 以 查询 此 异常 以 获取 错误 的 详细 信息 。 该 方法 必须 在 连 
接 URLConnection 前 调用 。 
* void setFixedLengthStreamingMode(int contentLength) : 此 方法 用 于 在 预先 已 知 
内 容 长 度 时 启用 没有 进行 内 部 缓冲 的 HTTP 请 求 正文 的 流 。 如 果 应 用 程序 尝试 写 
和信 的 数据 多 于 指示 的 内 容 长 度 , 或 者 应 用 程序 在 写 人 指示 的 内 容 长 度 前 关闭 了 
OutputStream ,将 抛 出 异常 。 启 用 输出 流 时 ,不 能 自动 处 理 验证 和 重 定 向 。 如 果 需 
要 验证 和 重 定向 , 则 在 读 取 响 应 时 将 抛 出 HttpRetryException。 可 以 查询 此 异常 以 
获取 错误 的 详细 信息 。 该 方法 必须 在 连接 URL Connection 前 调用 。 
3. HttpURLConnection 连接 
当 设置 好 HttpURLConnection 的 连接 参数 后 , 即 可 以 通过 connect() 方 法 进行 网 络 连 
接 。 如 果 在 已 打开 连接 (此 时 connected() 方 法 返回 值 为 true) 的 情况 下 调用 connect() 方 
法 , 则 忽略 该 调用 。 
注意 : HttpURLConnection 的 connect() 方 法 实际 上 只 是 建立 了 一 个 与 服务 器 的 tcp 
连接 ,并 没有 实际 发 送 http 请 求 。 无 论 是 post 请 求 方 式 还 是 get 请 求 方式 ,http 请 求实 际 
上 直到 HttpURLConnection 的 getInputStream() 这 个 方法 里 面 才 正式 发 送出 去 。 
如 果 服 务 器 近期 不 太 可 能 有 其 他 请 求 , 可 以 调用 disconnect() 断 开 连 接 。disconnect() 
并 不 意味 着 可 以 对 其 他 请 求 重用 此 HttpURLConnection 实例 。 
在 使 用 HttpURLConnection 进行 网 络 连接 时 需要 注意 : 
。 一 般 需 要 通过 setConnectTimeout() 方 法 设置 连接 超时 ,如 果 网 络 不 好 ,Android 系 
统 在 超过 默认 时 间 后 会 收回 资源 ,中 断 操 作 。 
。 通过 getResponseCode() 对 响应 码 进行 判断 。 如 果 返 回 的 响应 码 是 200, 则 表示 连 
接 成 功 。 
。 在 对 大 文件 进行 操作 时 ,要 将 文件 写 到 SDCard 上 ,不 要 直接 写 到 手机 内 存 上 。 
。 操作 大 文件 时 ,要 一 边 从 网 络 上 读 取 , 一 边 往 SDCard 上 写 , 以 便 减少 手机 内 存 的 
使 用 。 
。 对 文件 流 操作 完毕 后 要 记得 及 时 关闭 。 


5.2.2 HttpURLConnection 数据 交换 


HttpURLConnection API 提供 了 一 系列 的 get 方 法 来 获取 网 络 传递 的 信息 ,主要 有 以 
下 几 种 。 
* Object getContentO : 获取 该 URLConnection 的 内 容 。 
* String getHeaderField(String name): 获取 指定 响应 头 字段 的 值 。 经 常 有 可 能 访问 
的 头 字段 有 如 下 内 容 。 
> getContentEncodingO : 获取 content-enconding 响应 头 字 段 的 值 。 
> getContentLength(): 获取 content-length 响应 头 字段 的 值 。 
» getContentTypeO : 获取 contet-type 响应 头 字 段 的 值 。 
> getDateO : 获取 date 响应 头 字段 的 值 。 
> getExpiration() : 获取 expires 响应 头 字 段 的 值 。 
> getLastModified() : 获取 last-modified 响应 头 字段 的 值 。 
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InputStream getInputStream(): 返回 从 此 打开 的 连接 读 取 的 输入 流 。 在 读 取 返 回 
的 输入 流 时 ,如 果 在 数据 可 供 读 取 之 前 达到 读 入 超时 时 间 , 则 会 抛 出 SocketTime- 
outException, 

OutputStream getOutputStreamO ; 返回 写 人 此 连接 的 输出 流 。 

int getResponseCode(): 从 HTTP 响应 消息 获取 状态 码 。 如 果 无 法 从 响应 中 识别 
任何 代码 ( 即 响 应 不 是 有 效 的 HTTP), 则 返回 一 1。 常 见 的 状态 码 包 括 HTTP_OK 
(状态 码 为 200 ,表示 服务 器 成 功 返 回 网 页 ) HTTP_NOT_FOUND( 状 态 码 为 404， 
表示 请 求 的 网 页 不 存在 ) .HTTP_SERVICE_UNAVAILABLE( 状 态 码 为 503 ,表示 
服务 器 超时 ) 等 。 

String getResponseMessage() : 获取 与 来 自 服务 器 的 响应 代码 一 起 返回 的 HTTP 
响应 消息 (如 果 有 )。 如 果 无 法 从 响应 识别 任何 字符 (结果 不 是 有 效 的 HTTP) , 则 返 
回 null。 

InputStream getErrorStream(): 如 果 连 接 失败 但 服务 器 仍然 发 送 了 有 用 数据 , 则 返 
回 错误 流 。 典 型 示例 是 , 当 HTTP 服务 器 使 用 404 响应 时 ,将 导致 在 连接 中 抛 出 
FileNotFoundException, 但 是 服务 器 同时 还 会 发 送 建议 如 何 操作 的 HTML 帮助 
页 。 此 方法 不 会 导致 启用 连接 。 如 果 没 有 建立 连接 ,或 者 在 连接 时 服务 器 没有 发 生 


错误 ,或 服务 器 出 错 但 没有 发 送 错误 数据 , 则 此 方法 返回 null。 这 是 默认 设置 。 


对 HTTP 资源 的 读 写 操作 是 通过 InputStream 和 OutputStream 进行 的 ,下 面 列 举 几 


个 常见 的 用 法 。 
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1. 使 用 POST 方式 请 求 数据 
使 用 POST 方式 请 求 数据 的 一 般 步 骤 如 下 。 
COD 确定 URL ,一 般 结构 为 uri。 例 如 


01 String uri = "http://localhost/njcit/login. jsp"; 
02 URLurl = new URL(uri); 


(2) 确定 请 求 参 数 。 


01 String params = "userName = valuel&loginPwd = value2& --"; 


(3) 通过 URL 8]£ HttpURLConnection Xf £ , 
(4) HttpURLConnection 设置 连接 可 读 写 数据 。 例 如 ， 


01 conn.setDoOutput(true); 
02 conn. setDoInput(true) ; 


(5) 通过 getOutputStream() 获 得 输出 流 对 象 ,进而 发 送 请 求 参数 。 例 如 


01 Printer out = new Printer(conn. getOutputStream()); 
02 out.write(params); 
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下 面 的 代码 演示 了 使 用 POST 方式 发 送 数据 的 过 程 : 


01 public static String doPost(String url, String param) { 


02 PrintWriter out = null; 

03 BufferedReader in = null; 

04 String result = ""; 

05 try { 

06 URL realUrl = new URL(url); 

07 // 打 开 和 URL 之 间 的 连接 

08 HttpURLConnection conn = (HttpURLConnection) realUrl 
09 . openConnection(); 

10 // 设 置 通用 的 请 求 属性 

11 conn. setRequestProperty("accept", "*/*"); 

12 conn. setRequestProperty( "connection", "Keep - Alive"); 
13 conn. setRequestMethod( "POST" ) ; 

14 conn. setRequestProperty( "Content - Type", 

15 "application/x- www - form — urlencoded"); 
16 conn. setRequestProperty("charset", "utf ~ 8"); 

17 conn. setUseCaches( false); 

18 // 发 送 POST 请 求 必须 设置 如 下 两 行 

19 conn. setDoOutput(true); 

20 conn. setDoInput(true); 

21 conn.setReadTimeout(TIMEOUT IN MILLIONS); 

22 conn. setConnectTimeout(TIMEOUT IN MILLIONS); 

23 

24 if (param != null && !param.trim().equals("")) ( 
25 / [3k Wt URLConnect ion 对 象 对 应 的 输出 流 

26 out = new PrintWriter(conn.getOutputStrean()); 
27 // 发 送 请 求 参数 

28 out. print(param); 

29 //flush 输 出 流 的 缓冲 

30 out. flush(); 

31 ) 

32 // X. BufferedReader 输入 流 来 读 取 URL 的 响应 

33 in = new BufferedReader( 

34 new InputStreamReader(conn. getInputStream())); 
35 String line; 

36 while ((line = in. readLine()) != null) { 

37 result += line; 

38 } 

39 } catch (Exception e) { 

40 e. printStackTrace(); 

41 } 

42 // 使 用 finally 块 来 关闭 输出 流 、 输 入 流 

43 finally { 

44 try { 

45 if (out != null) { 

46 out. close() ; 

47 } 

48 if (in != null) { 
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49 in.close(); 

50 } 

DT } catch (IOException ex) { 
52 ex. printStackTrace() ; 
53 } 

54 } 

55 return result; 

56 } 


代码 分 析 : param 是 请 求 参 数 ,请 求 参数 的 一 般 形 式 是 namel = valuel 8 name2 = 
value2, 14—15 行 设 置 本 次 连接 的 Content-type 为 application/x-www-form-urlencoded, 
表示 正文 是 UrlEncoded 编码 过 的 form 参数 。17 行 设 置 POST 请 求 不 能 使 用 缓存 。19 行 
设置 是 否 向 HttpURLConnection 输出 ,因为 是 POST 请 求 , 参 数 要 放 在 Http 正文 内 ,因此 
需要 设 为 true。 

HTTP 通信 中 使 用 最 多 的 是 GET 和 POST 两 种 请 求 。GET 请 求 可 以 获取 静态 页 面 ， 
也 可 以 把 参数 放 在 URL 字符 串 后 面 传递 给 服务 器 。POST 与 GET 的 不 同 之 处 在 于 POST 
的 参数 不 是 放 在 URL 字符 串 里 面 , 而 是 放 在 HTTP 请 求 数据 中 。 使 用 POST 请 求 时 ,不 
需要 在 URL 中 附加 任何 参数 ,这些 参 数 会 通过 cookie 或 者 session 等 其 他 方式 以 键 值 对 的 
形式 传送 到 服务 器 上 。 

注意 : 在 用 POST 方式 发 送 URL 请 求 时 ,URL 请 求 参数 的 设 定 都 必须 要 在 connectO 
方法 执行 之 前 完成 。 而 对 OutputStream 的 写 操 作 , 又 必须 要 在 InputStream 的 读 操 作 之 
前 。 如 果 InputStream 读 操 作 在 OutputStream 的 写 操 作 之 前 , 会 抛 出 java net. 
ProtocolException 异常 。 

2. 使 用 GET 方式 请 求 数据 

使 用 GET 方式 请 求 数据 的 一 般 步骤 如 下 。 

(D 确定 URL ,一 般 结构 为 uri 十 "?" 十 params。 例 如 : 


03 String uri = "http://localhost/njcit/login. jsp"; 
04 String params = "userName = valuel&loginPwd = value2& … "7 
05 URLurl = new URL(uri + params); 


© 通过 URL 调用 openConnection() 方 法 创建 HttpURLConnection WA, 

(3 HttpURLConnection 对 象 调 用 setConnectTimeout(int milisecond) 设 置 网 络 响应 时 
间 。 调 用 setRequestMethod(String method) 设 置 发 送 请 求 的 方法 。 

@ 通过 getInputStream() 获 得 输入 流 ,进而 获得 响应 。 

下 面 的 代码 演示 了 使 用 GET 方式 请 求 数据 的 过 程 : 


01 public static String doGet(String urlStr) { 


02 URL url = null; 
03 HttpURLConnection conn = null; 
04 InputStream is = null; 
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05 ByteArrayOutputStream baos = null; 

06 try { 

07 url = new URL(urlStr); 

08 conn = (HttpURLConnection) url. openConnection(); 
09 conn.setReadTimeout(TIMEOUT IN MILLIONS); 
10 conn. setConnectTimeout(TIMEOUT IN MILLIONS); 
m conn. setRequestMethod( "GET" ) ; 

12 conn. setRequestProperty("accept", "* / x"); 
13 conn. setRequestProperty("connection", "Keep - Alive"); 
14 if (conn. getResponseCode() == 200) { 

15 is = conn.getInputStream(); 

16 baos = new ByteArrayOutputStrean(); 

TT int len = -1; 

18 byte[] buf = new byte[128]; 

19 

20 while ((len = is.read(buf)) != -1)( 
21 baos.write(buf, 0, len); 

22 } 

23 baos. flush(); 

24 return baos. toString(); 

25 } else ( 

26 throw new Runt imeException(" responseCode is not 200 ... "); 
27 } 

28 

29 } catch (Exception e) { 

30 e. printStackTrace( ) ; 

31 } finally { 

32 try { 

33 if (is != null) 

34 is.close(); 

35 ) catch (IOException e) ( 

36 } 

37 try { 

38 if (baos != null) 

39 baos. close(); 

40 } catch (IOException e) { 

41 } 

42 conn. disconnect(); 

43 } 

44 

45 return null; 

46 } 


在 GET 请 求 时 ,一 般 在 URL 中 带 有 请 求 的 参数 ,请 求 的 URL 格式 通常 为 : "http:// 
XXX. XXX X.com/X X.aspx? param= value") 
在 使 用 HttpURLConnection 进行 数据 交换 时 ,需要 注意 如 下 事项 : 
。 上 传 数据 至 服务 器 时 ( 即 向 服务 器 发 送 请 求 ) ,如 果 知道 上 传 数据 的 大 小 ,应 该 显 式 
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使 用 setFixedLengthStreamingMode(int) 来 设置 上 传 数据 的 精确 值 ; 如 果 不 知道 上 
传 数据 的 大 小 , 则 应 使 用 setChunkedStreamingMode(int) (通常 使 用 默认 值 0 作为 
实际 参数 传人 ) 。 如 果 两 个 方法 都 未 设置 , 则 系统 会 强制 将 “请 求 体 ” 中 的 所 有 内 容 
都 缓存 至 内 存 中 (在 通过 网 络 进行 传输 之 前 ) ,这样 会 浪费 “ 堆 ” 内 存 ( 甚 至 可 能 耗 
A) ,并 加 重 隐患 。 

。 如 果 通 过 流 输 入 或 输出 少量 数据 , 则 需要 使 用 带 缓冲 区 的 流 ( 如 BufferedInputStream) ; 
大 量 读 取 或 输出 数据 时 ,可 忽略 缓冲 流 ( 不 使 用 缓冲 流 会 增加 磁盘 IO ,默认 的 流 操 
作 是 直接 进行 磁盘 T/O 操作 的 ) 。 

。 当 需 要 传输 (输入 或 输出 ) 大 量 数据 时 ,使 用 * 流 ?来 限制 内 存 中 的 数据 量 , 即 将 数据 
直接 放 在 “ 流 ” 中 ,而 不 是 存储 在 字 节 数组 或 字符 串 中 (这 些 都 存储 在 内 存 中 )。 


5.3 HttpClient 编程 


在 Android 开发 中 , Android SDK 附带 了 Apache 的 Http 服务 工具 HttpClient。 
Apache HttpClient 是 一 个 开源 项 目 , 弥 补 了 java. net 灵活 性 不 足 的 缺点 ,提供 了 对 HTTP 
协议 的 全 面 支持 ,为 客户 端的 HTTP 编程 提供 高 效 . 最 新 、 功 能 丰富 的 工具 包 支 持 。 


5.3.1 HttpClient 简介 


HttpClient 是 Apache Jakarta Common 下 的 子 项 目 , 可 以 用 来 提供 高 效 的 ,最 新 的 、 功 
能 丰富 的 支持 HTTP 协议 的 客户 端 编程 工具 包 , 并 且 它 支持 HTTP. 协议 最 新 的 版 本 和 
建议 。 

1. 功能 介绍 

org. apache. http. client. HttpClient 接口 提供 的 主要 功能 包括 : 

。 实 现 了 所 有 HTTP 的 方法 (GET、POST、PUT、HEAD 等 ) 。 

。 支 持 自动 转向 ?。 

。 支持 HTTPS 协议 。 

。 支持 验证 会 话机 制 2 。 

。 支持 代理 服务 器 等 。 

2. 与 HttpURLConnection 对 比 

HttpURLConnection 和 HttpClient 都 支持 HTTPS 协议 .IPv6、 以 流 的 形式 进行 上 传 
和 下 载 .配置 超时 时 间 以 及 连接 池 等 功能 。 两 者 的 比较 见 表 5-2. 


© HttpClient 支持 自动 转向 处 理 , 但 是 像 POST 和 PUT 这 种 要 求 接受 后 继 服 务 的 请 求 方式 ,暂时 不 支持 自动 转 
向 ,因此 如 果 碰 到 POST 方式 提交 后 返回 的 是 301 或 者 302, 则 需要 自己 处 理 。 

Q HttpClient 的 好 处 在 于 ,同一 个 手机 客户 端 在 登录 验证 通过 后 ,可 以 保持 这 个 客户 的 会 话 状态 ,在 同一 个 站 点 的 
其 他 业务 模块 中 进行 新 的 业务 实现 时 ,可 以 视 作 同一 个 登录 客户 。 该 方式 类 似 于 Web 应 用 中 的 Session 会 话机 制 ,可 以 
从 反复 的 验证 业务 中 解放 出 来 ,提高 用 户 的 体验 。 
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X 5-2 HttpURLConnection 和 HttpClient 的 比较 


比较 HttpURLConnection HttpClient 





* HttpURLConnection 对 大 部 分 工作 进行 了 包 |。 HttpClient 库 要 丰富 很 多 ,提供 了 很 多 工具 , 封 
装 , 屏 项 了 不 需要 的 细节 ,适合 开发 人 员 直 接 | RS hup 的 请 求 头 .参数 ,内容 体 .响应 ,还 有 

功能 | ”调用 。 一 些 高 级 功能 ,以 及 对 代理 .COOKIE、 鉴 权 、 压 

用 法 |。 HttpURLConnection 在 2. 3 版 本 中 增加 了 一 缩 、 连 接 池 的 处 理 。 

X HTTPS 方面 的 改进 ,4. 0 版 本 增加 了 一 些 |。 HttpClient 高 级 功能 代码 写 起 来 比较 复杂 ,对 

响应 的 缓存 开发 人 员 的 要 求 会 高 一 些 

HttpUrlConnection 直接 支持 GZIP 压缩 。 

HttpUrlConnection 直接 支持 系统 级 连接 池 ,|。 HttpClient 也 支持 GZIP 压缩 ,但 要 自己 写 代码 

即 打开 的 连接 不 会 直接 关闭 ,在 一 段 时 间 内 | “处理 。 








所 有 程序 可 共用 。 * HttpClient 也 能 支持 系统 级 连接 池 , 但 不 如 
。 HttpUrlConnection 直接 在 系统 层面 做 了 缓 | ”HttpUrlConnection 直接 进行 系统 的 底层 支持 
存 策略 处 理 (4. 0 版 本 以 上 ) ,加 快 了 重复 请 求 | ”那样 好 
的 速度 
。 HttpURLConnect 是 一 个 通用 的 .适合 大 多 数 
应 用 的 轻 量 级 组 件 。 这 个 类 起 步 比 较 晚 ,很 
容易 在 主要 API 上 做 稳步 的 改善 。 但 是 
HttpURLConnection 在 Android 2. 2 及 以 下 
版 本 上 存在 一 些 令 人 厌烦 的 bug, 尤 其 是 在 读 |HttpClient 适用 于 Web 浏览 器 ,它们 是 可 扩展 的 ， 
未 来 取 InputStream 时 调用 close() 方 法 ,就 有 可 | 并 且 拥 有 大 量 稳 定 的 API。 但 是 ,在 不 破坏 其 兼容 
发 展 能 会 导致 连接 池 失 效 了 。 性 的 前 提 下 很 难 对 如 此 多 的 API 做 修改 。 因 此 ， 


Android 团队 未 来 的 工作 会 将 更 多 的 时 间 放 |Android 团队 对 修改 优化 Apache HTTP Client 表 
在 优化 HttpURLConnection 上 , 它 的 API 简 | 现 得 并 不 积极 

单 , 体 积 较 小 ,因而 非常 适用 于 Android 项 
目 。 压缩 和 缓存 机 制 可 以 有 效 地 减少 网 络 访 
问 的 流量 ,在 提升 速度 和 省 电 方面 也 起 到 了 
较 大 的 作用 





如 果 一 个 Android 应 用 需要 向 指定 页 面 发 送 请 求 ， 
3a _| 但 该 页 面 并 不 是 一 个 简单 的 页 面 ,只 有 当 用 户 已 

选用 | 人 ro & 3 及 以 上 版 本 建议 选用 HttpURI- 名 登录 ,而 且 登 录用 户 的 用 户 名 有 效 时 才 可 访问 
、|Connection,2. 2 及 以 下 版 本 建议 选用 HttpCli- r 
建议 ent。 新 的 应 用 都 建议 使 用 HttpURLConnection BO. MEAM HUR Connec TEM E 
t i 个 被 保护 的 页 面 , 那 么 需要 处 理 的 细节 就 太 复杂 


了 。 这 种 情况 建议 使 用 HttpClient 








Google 在 其 SDK 文档 中 通过 博客 说 明 , 对 于 Gingerbread 及 其 以 后 的 版 本 来 说 ， 
HttpURLConnection 是 最 好 的 选择 ,其 简洁 的 API 和 轻 量 级 的 实现 用 于 Android 系统 再 适 
合 不 过 了 ,同时 ,对 开发 者 透明 的 压缩 和 缓存 实现 ,可 以 减少 网 络 数据 传输 量 ,提高 程序 响应 
速度 ,也 节约 设备 电源 。 不 过 ,HttpClient 封装 了 很 多 有 用 的 工具 ,便于 开发 者 使 用 ,并 提高 
开发 效率 。 

3. 一 般 使 用 步骤 

使 用 HttpClient 实现 Http 编程 的 一 般 步 骤 如 下 : 

(D 使 用 DefaultHttpClient 类 实例 化 HttpClient 对 象 。 
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Q 如 果 需 要 发 送 GET 请 求 , 则 创建 HttpGet 对 象 ; 如 果 需 要 发 送 POST 请 求 , 则 创建 
HttpPost 对 象 。 

@ 如 果 需 要 发 送 请 求 参数 ,可 以 调用 HttpGet 以 及 HttpPost 共同 的 setParams 
(HttpParams params) 方法 来 添加 请 求 参数 , HttpPost 要 通过 setEntity ( HttpEntity 
entity) 的 方式 设置 请 求 参 数 。 

© 将 要 请 求 的 URL 通过 构造 方法 传人 HttpGet 或 HttpPost WA. 

© 调用 HttpClient 的 execute() 方 法 发 送 HTTP GET sk HTTP POST 请 求 ,并 返回 
一 个 响应 对 象 HttpResponse。 

© 通过 HttpResponse 接口 的 getEntity() 方 法 获得 HttpEntity 响应 对 象 , 该 对 象 包装 
了 响应 内 容 , 通 过 该 对 象 的 解析 可 以 得 到 响应 内 容 。 

CD 通过 响应 对 象 HttpResponse 的 getAllHeadersO ,getHeaders(String name) 等 方法 
获得 服务 响应 头 。 

下 面 的 AsyncTask 实现 类 代码 演示 了 使 用 HttpPost 登录 人 人 网 的 功能 。 


01 class PostLoader extends AsyncTask < Void, Integer, String> { 


02 

03 @Override 

04 protected String doInBackground(Void... params) { 

05 String httpUrl = "http://3g. renren. com/login. do"; 

06 String strResult = ""; 

07 

08 HttpPost httpRequest = new HttpPost(httpUrl); 

09 List <NameValuePair> params = new ArrayList < NameValuePair >(); 
10 _params. add(new BasicNameValuePair("email", "******")); 

‘it .params. add(new BasicNameValuePair("Spassword", " xsxxxx ")); 
12 try { 

T3 HttpEntity httpentity = new UrlEncodedFormEntity( params, 
14 "UTF - 8"); 

15 httpRequest. setEntity(httpentity) ; 

16 

17 HttpClient httpclient = new DefaultHttpClient(); 

18 HttpResponse httpResponse = httpclient. execute( httpRequest); 
19 if (httpResponse.getStatusLine().getStatusCode() == 

20 HttpStatus.SC OK) { 

21 strResult = EntityUtils. toString(httpResponse. getEntity()); 
22 } 

23 } catch (UnsupportedEncodingException e) { 

24 } catch (ClientProtocolException e) { 

25 } catch (ParseException e) { 

26 } catch (IOException e) { 

27 } 

28 

29 return strResult; 

30 } 

31 

32 @Override 

33 protected void onPostExecute(String result) { 
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34 mWebView. loadData(result, "text/html; charset = UIF- 8", null); 
35 } 

36 } 

4. 单 实例 模式 


在 实际 项 目 中 ,可 能 在 多 处 需要 进行 HTTP 通信 ,这 时 候 不 需要 为 每 个 请 求 都 创建 一 
个 新 的 HttpClient。 对 于 一 个 通信 单元 甚至 是 整个 应 用 程序 ,Apache 强烈 推荐 只 使 用 一 个 
HttpClient 的 实例 。 例 如 : 


01 private static HttpClient httpClient = null; 


02 

03 private static synchronized HttpClient getHttpClient() { 

04 if(httpClient == null) { 

05 final HttpParams httpParams = new BasicHttpParams() ; 
06 httpClient - new DefaultHttpClient(httpParams); 

07 f 

08 

09 return httpClient; 

10 ] 


DefaultHttpClient 是 常用 的 一 个 用 于 实现 HttpClient #OA MFA. HttpClietnt 定义 
的 主要 抽象 方法 就 是 execute() ,下 面 两 种 是 常用 的 方法 。 
* HttpResponse execute (HttpUriRequest request); 通过 HttpUriRequest 对 象 的 执 
行 来 返回 一 个 HttpResponse 对 象 。 
* HttpResponse execute ( HttpUriRequest request, HttpContext context); 通过 
HttpUriRequest 对 象 和 HttpContext 对 象 的 执行 来 返回 一 个 HttpResponse WK. 
Apache 对 网 络 连接 进行 了 管理 ,对 于 已 经 和 服务 端 建立 了 连接 的 应 用 来 说 ,再 次 调用 
HttpClient 进行 网 络 数 据 传输 时 ,不 必 重 新 建立 新 连接 ,而 可 以 重用 已 经 建立 的 连接 。 客 户 
端 程序 员 不 需要 做 任何 配置 ,这 样 无 疑 可 以 减少 开销 ,提升 速度 。 
注意 : Apache 的 连接 管理 并 不 会 主动 释放 建立 的 连接 ,需要 程序 员 在 不 用 的 时 候 手 动 
5. 连接 参数 的 设置 
HttpParams 保存 Http 请 求 设 定 的 参数 对 象 。 另 外 ,还 有 HttpConnectionParams 类 ， 
主要 提供 对 Http 连接 参数 (如 连接 超时 时 间 等 ) 进 行 设 定 的 方法 ,例如 : 


01 private static synchronized HttpClient getHttpClient() { 


02 if(httpClient == null) { 

03 final HttpParams httpParams = new BasicHttpParams(); 
04 

05 //timeout: get connections from connection pool 

06 ConnManagerParams.setTimeout(httpParams, 1000); 

07 //timeout: connect to the server 

08 HttpConnectionParams.setConnectionTimeout(httpParams, 
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DEFAULT SOCKET TIMEOUT); 
//timeout: transfer data from server 
HttpConnectionParams. setSoTimeout(httpParams, 
DEFAULT SOCKET TIMEOUT); 


//set max connections per host 

ConnManagerParams. setMaxConnectionsPerRoute(httpParams, 
new ConnPerRouteBean(DEFAULT HOST CONNECTIONS)); 

//set max total connections 

ConnManagerParams. setMaxTotalConnections(httpParams, 
DEFAULT MAX CONNECTIONS); 


//use expect - continue handshake 

HttpProtocolParams. setUseExpectContinue(httpParams, true); 
//disable stale check 

HttpConnect ionParams. setStaleCheckingEnabled(httpParams, false); 


HttpProtocolParams. setVersion(httpParams, HttpVersion.HTTP 1 1); 
HttpProtocolParams. setContentCharset(httpParams, HTTP.UTF 8); 


HttpClientParams.setRedirecting(httpParams, false); 


//set user agent 

String userAgent - "Mozilla/5.0 (Windows; U; Windows NT 5.1; zh- CN; 
rv:1.9.2) Gecko/20100115 Firefox/3.6"; 

HttpProtocolParams. setUserAgent(httpParams, userAgent); 


// disable Nagle algorithm 
HttpConnectionParams.setTcpNoDelay(httpParams, true); 


HttpConnectionParams.setSocketBufferSize(httpParams, 
DEFAULT SOCKET BUFFER SIZE); 


//scheme: http and https 

SchemeRegistry schemeRegistry - new SchemeRegistry(); 

schemeRegistry. register(new Scheme("http", 
PlainSocketFactory. getSocketFactory(), 80)); 

schemeRegistry. register(new Scheme("https", 
SSLSocketFactory. getSocketFactory(), 443)); 


ClientConnectionManager manager = new ThreadSafeClientConnManager( 
httpParams, schemeRegistry) ; 
httpClient = new DefaultHttpClient(manager, httpParams) ; 


return httpClient; 
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06 一 09 行 通过 setTimeout() 和 setConnectionTimeout() 方 法 进行 超时 设置 ,让 连接 在 
超过 时 间 后 自动 失效 ,释放 占用 资源 。 

注意 : 设置 连接 超时 和 请 求 超时 ,以 下 两 个 超时 的 意义 不 同 。 

* ConnManagerParams. setTimeout(): ConnectionManager 管理 的 连接 池 中 取出 连 
接 的 超时 时 间 。 

* HttpConnectionParams. setConnectionTimeout(); 通过 网 络 与 服务 器 建立 连接 的 
超时 时 间 。Httpclient 包 中 通过 一 个 异步 线程 去 创建 与 服务 器 的 Socket 连接 ,这 就 
是 该 Socket 连接 的 超时 时 间 。 

15 一 19 行 的 作用 是 连接 数 限 制 。 配 置 每 台 主 机 最 多 连接 数 和 连接 池 中 的 最 多 连接 总 
数 ,对 连接 数量 进行 限制 。 其 中 ,DEFAULT_HOST_CONNECTIONS f DEFAULT _ 
MAX_CONNECTIONS 是 由 客户 端 程序 员 根 据 需 要 而 设置 的 。 

22 行 的 作用 是 持续 握手 验证 。 在 认证 系统 或 其 他 可 能 遭 到 服务 器 拒绝 应 答 的 情况 下 
(如 登录 失败 ) ,如 果 发 送 整 个 请 求 体 , 则 会 大 大 降低 效率 。 此 时 ,可 以 先 发 送 部 分 请 求 ( 如 只 
发 送 请 求 头 ) 进 行 试探 ,如 果 服 务 器 愿意 接收 , 则 继续 发 送 请 求 体 。 

24 行 的 作用 是 关闭 旧 连 接 检查 的 配置 。HttpClient 为 了 提升 性 能 ,默认 采用 了 “重用 
连接 ”机 制 , 即 在 有 传输 数据 需求 时 ,会 首先 检查 连接 池 中 是 否 有 可 供 重用 的 连接 ,如 果 有 ， 
则 会 重用 连接 。 同 时 ,为 了 确保 该 “被 重用 ”的 连接 确实 有 效 ,会 在 重用 之 前 对 其 进行 有 效 性 
检查 。 这 个 检查 大 概 会 花费 15—30 毫秒 。 关 闭 该 检查 举措 ,会 稍微 提升 传输 速度 ,但 也 可 
能 出 现 “ 旧 连接 ”过 久 而 被 服务 器 端 关闭 ,从 而 出 现 1/0 异常 。 

6. 多 线程 安全 管理 

如 果 应 用 程序 采用 了 多 线程 进行 网 络 访问 , 则 应 该 使 用 Apache 封装 好 的 线程 安全 管 
理 类 ThreadSafeClientConnManager 来 进行 管理 ,这 样 能 够 更 有 效 且 更 安全 地 管理 多 线程 
和 连接 池 中 的 连接 。 例 如 : 


01 ClientConnectionManager manager = new ThreadSafeClientConnManager( 
02 httpParams, schemeRegistry); 
03 httpClient = new DefaultHttpClient(manager, httpParams); 


HTTP 连接 是 复杂 的 、 有 状态 的 、 线 程 不 安全 的 ,对 象 需要 正确 的 管理 以 便 正确 地 执行 
功能 。HTTP 连接 在 同一 时 间 仅 仅 只 能 由 一 个 执行 线程 来 使 用 。HttpClient 采用 一 个 特殊 实 
体 来 管理 访问 HTTP 的 连接 ,这 被 称 为 HTTP 连接 管理 器 ,代表 了 ClientConnectionManager 
接口 。 一 个 HTTP 连接 管理 器 的 目的 是 作为 工厂 服务 于 新 的 HTTP 连接 ,管理 持久 连接 
和 同步 访问 持久 连接 来 确保 同一 时 间 仅 有 一 个 线程 可 以 访问 一 个 连接 。 

下 面 介绍 一 个 使 用 Application 结合 HttpClient 单 实例 模式 实现 线程 安全 的 HttpClient 
功能 。 

新 建 HTTPClientApplication ,代码 如 下 ， 


01 public class HTTPClientApplication extends Application { 
02 private HttpClient mHttpClient - null; 
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03 
04 
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31 
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private static final String CHARSET - HTTP.UTF 8; 


@Override 
public void onCreate() { 
super. onCreate() ; 
mHttpClient = this.createHttpClient(); 


@Override 

public void onTerminate() { 
super. onTerminate( ) ; 
this. shutdownHttpClient(); 


@Override 

public void onLowMemory() { 
super. onLowMemory( ) ; 
this. shutdownHttpCl ient() ; 


PE 
* 创建 HttpClient 实例 
* @return 
*/ 
private HttpClient createHttpClient(){ 
HttpParams params - new BasicHttpParams(); 
HttpProtocolParams. setVersion(params, HttpVersion.HTTP 1 1); 
HttpProtocolParams. setContentCharset(params, CHARSET); 
HttpProtocolParams. setUseExpectContinue(params, true); 
ConnManagerParams.setTimeout(params, 1000); 
HttpConnectionParams.setConnectionTimeout(params, 2000); 
HttpConnectionParams.setSoTimeout(params, 4000); 
SchemeRegistry schReg - new SchemeRegistry(); 
SchReg. register(new Scheme(" http", 
PlainSocketFactory.getSocketFactory(), 80)); 
SchReg. register(new Schene(" https", 
SSLSocketFactory. getSocketFactory(), 443)); 


// 使 用 线程 安全 的 连接 管理 来 创建 HttpClient 
ClientConnectionManager conMgr = new 

ThreadSafeClientConnManager(params, schReg); 
HttpClient client = new DefaultHttpClient(conMgr, params); 
return client; 


private void shutdownHttpClient()( 
if(mHttpClient != null && mHttpClient.getConnectionManager() != null)( 
mHttpClient. getConnectionManager( ). shutdown() ; 
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52 } 

53 

54 public HttpClient getHttpClient(){ 
55 return mHttpClient; 

56 } 

ST 

58 } 


Application 和 Activity, Service 一 样 是 Android 框架 的 一 个 系统 组 件 , 当 Android 程 
序 启动 时 ,系统 会 创建 一 个 Application 对 象 , 用 来 存储 系统 的 一 些 信息 。Android 系统 会 
为 每 个 程序 运行 时 创建 一 个 Application 类 的 对 象 且 仅 创 建 一 个 ,所 以 Application 可 以 说 
是 单 实例 模式 的 一 个 类 , 且 Application 对 象 的 生命 周期 是 整个 程序 中 最 长 的 , 它 的 生命 周 
期 就 等 于 这 个 程序 的 生命 周期 。 因 为 它 是 全 局 的 、 单 例 的 ,所 以 在 不 同 的 Activity Service 
中 获得 的 对 象 都 是 同一 个 对 象 。 因 此 ,可 以 通过 Application 来 进行 一 些 数据 传递 .数据 共 
享 , 数 据 缓存 等 操作 。 

继承 自 Application 的 类 需要 在 AndroidManifest. xml 的 application 标签 中 进行 注册 ， 
例如 : 


01 «application android:name- "cn.njcit. project05. meta. HttpClientApplication" 
02 android: icon = "@drawable/ icon” 
03 android: label = "@string/app_name"> 


使 用 这 个 HTTPClientApplication 的 方法 是 : 在 Activity 的 onCreate() 生 命 周 期 方法 
中 ,通过 “mHTTPClientApplication = (HTTPClientApplication) getApplication ();” 和 
mHTTPClientApplication. getHttpClient() 就 可 以 得 到 HttpClient 的 实例 。 可 以 看 到 ,这 
个 HttpClient 实例 在 低 内 存 和 应 用 退出 时 关闭 连接 管理 器 ,释放 资源 。 


5.3.2 HttpGet 


与 HttpURLConnection 相同 , HttpClient 也 存在 GET 和 POST 两 种 方式 。 

在 HttpClient 中 ,可 以 使 用 HttpGet 对 象 来 通过 GET 方式 进行 数据 请 求 操作 , 当 获得 
HttpGet 对 象 后 就 可 以 使 用 HttpClient 的 execute() 方 法 来 向 服务 器 发 送 请 求 。 在 发 送 的 
GET 请 求 被 服务 器 响应 后 ,会 返回 一 个 HttpResponse 响应 对 象 ,利用 这 个 响应 的 对 象 就 能 
够 获得 响应 回来 的 状态 码 , 如 200,400,401 等 。 

使 用 HttpGet 需要 以 下 6 SAR: 

QD 创建 HttpClient 的 实例 。 

@ 创建 连接 方法 的 HttpGet 实例 ,并 在 构造 方法 中 传人 待 连接 的 地 址 。 对 于 发 送 请 求 
的 参数 ,GET 和 POST 使 用 的 方式 不 同 ,GET 方式 可 以 使 用 拼接 字符 串 的 方式 ,把 参数 拼 
接 在 URL 结尾 ; POST 方式 需要 使 用 setEntity(HttpEntity entity) 方 法 来 设置 请 求 参数 。 

© 调用 第 一 步 中 创建 好 的 HttpClient 实例 的 execute() 方 法 来 执行 第 二 步 中 创建 好 的 
HttpGet 实例 。 

© 读 取 返回 的 HttpResponse 实例 ,通过 HttpResponse 接口 的 getEntity() 方 法 返回 
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响应 信息 ,并 进行 处 理 。 
@ 释放 连接 。 无 论 执 行 方法 是 否 成 功 ,都 必须 释放 连接 。 
© 对 得 到 后 的 内 容 进行 处 理 。 
下 面 的 代码 根据 以 上 的 步骤 实现 了 使 用 GET 方法 从 网 络 获取 图 像 的 功能 : 


01 public static Bitmap sendGetResquest(String path) { 


02 Bitmap bitmap = null; 

03 HttpGet httpGet = new HttpGet(path); 

04 HttpClient httpClient = new DefaultHttpClient(); 

05 

06 try { 

07 HttpResponse httpResponse = httpClient. execute(httpGet) ; 

08 int reponseCode = httpResponse.getStatusLine().getStatusCode(); 
09 if(reponseCode == HttpStatus.SC OK) { 

10 InputStream inputStream = httpResponse.getEntity().getContent(); 
11 bitmap = BitmapFactory. decodeStream(inputStream) ; 

12 inputStream. close(); 

13 } 

14 } catch (ClientProtocolException e) { 

45 e. printStackTrace( ) ; 

16 } catch (IOException e) { 

17 e. printStackTrace( ) ; 

18 } 

19 return bitmap; 

20 ] 


07 47 HttpResponse 接口 里 定义 了 一 系列 的 set, get 方法 。 举 例如 下 。 

* HttpEntity getEntityO : 得 到 一 个 HttpEntity WA. 

StatusLine getStatusLine(): 得 到 一 个 StatusLine( 也 就 是 HTTP 协议 中 的 状态 行 。 
HTPP 状态 行 由 三 部 分 组 成 , 即 HTTP. 协议 版 本 、 服 务 器 发 回 的 响应 状态 代码 、 状 
态 码 的 文本 描述 ) 接 口 的 实例 对 象 。 例 如 : 


01 HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP 1 1, 


02 HttpStatus.SC OK, "OK"); 

03 response. getProtocolVersion(); //BTTP/1.1 

04 response. getStatusLine( ). getStatusCode( ) ; //200 

05 response. getStatusLine( ) . getReasonPhrase( ) ; //0K 

06 response. getStatusLine( ). toString() ; //HTTP/1.1 200 OK 


* Locale getLocaleO : 得 到 Locale $A. 

10 行 通过 getEntity () 得 到 一 个 HttpEntity XJ 2. HttpEntity 是 一 个 接口 ,通过 
getContent() 方 法 得 到 一 个 输入 流 对 象 InputStream, 可 以 用 这 个 流 来 操作 文件 (例如 保存 
文件 到 SD 卡 中 )。 

注意 , 当 需 要 传输 大 量 数据 时 ,不 应 使 用 字符 串 或 者 字 节 数组 ,因为 它们 会 将 数据 缓存 
至 内 存 。 当 数据 过 多 ,尤其 在 多 线程 情况 下 ,很 容易 造成 内 存 溢 出 (Out Of Memory, 
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OOM). 而 HttpClient 能 够 有 效 处理 实 体 流 。 这 些 “ 流 ”不 会 缓存 至 内 存 , 而 是 直接 进行 数 
据 传输 。 采 用 "请求 流 /响应 流 ” 的 方式 进行 传输 ,可 以 减少 内 存 占 用 ,降低 内 存 溢 出 的 风险 。 
例如 : 

01 //Get method: getResponseBodyAsStream() 

02 //not use getResponseBody(), or getResponseBodyAsString() 

03 GetMethod httpGet = new GetMethod(url); 

04 InputStream inputStream = httpGet.getResponseBodyAsStrean(); 

05 //Post method: getResponseBodyAsStream( ) 


06 PostMethod httpPost = new PostMethod(url); 
07 InputStream inputStream = httpPost. getResponseBodyAsStream( ) ; 


5.3.3 HttpPost 


POST 方法 用 来 向 目的 服务 器 发 出 请 求 ,要 求 它 接收 被 附 在 请 求 后 的 实体 ,并 把 它 当 作 
请 求 队 列 中 请 求 URI 所 指定 资源 的 附加 新 子 项 。POST 被 设计 成 用 统一 的 方法 实现 下 列 
功能 : 

。 对 现 有 资源 的 注释 。 

。 向 电子 公告 栏 新 闻 组 、 邮 件 列表 或 类 似 讨论 组 发 送 消息 。 

。 提交 数据 块 ,如 将 表单 的 结果 提交 给 数据 处 理 过 程 。 

。 通过 附加 操作 来 扩展 数据 库 。 

POST 方法 与 GET 方法 的 使 用 步骤 大 体 相 同 。 当 使 用 POST 方式 时 ,可 以 使 用 
HttpPost 类 来 进行 操作 。 当 获取 了 HttpPost 对 象 后 ,就 需要 向 这 个 请 求 体 传人 键 值 对 ,这 
个 键 值 对 可 以 使 用 NameValuePair 对 象 来 进行 构造 ,然后 再 使 用 HttpRequest 对 象 最 终 构 
造 的 请 求 体 ,最 后 使 用 HttpClient 的 execute() 方 法 来 发 送 请 求 ,并 在 得 到 响应 后 返回 一 个 
HttpResponse 对 象 。 

下 面 是 一 个 HttpPost 请 求 示例 : 


01 public static String sendPostResquest(String path, Map < String, 


02 String» params, String encoding) ( 

03 List <NameValuePair> list = new ArrayList < NameValuePair >() ; 
04 

05 if((params != null) && ! params. isEmpty()) { 

06 for(Map. Entry < String, String> param : params. entrySet()) { 
07 list. add( new BasicNameValuePair(param. getKey(), 

08 param.getValue())); 

09 } 

10 } 

11 

12 try { 

13 UrlEncodedFormEntity entity = new UrlEncodedFormEntity(list, 
14 encoding) ; 

15 HttpPost httpPost = new HttpPost(path) ; 

16 httpPost. setEntity(entity) ; 

17 HttpClient client = new DefaultHttpClient(); 
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18 HttpResponse httpResponse = client.execute(httpPost); 
19 int reponseCode = httpResponse.getStatusLine().getStatusCode(); 
20 if(reponseCode -- HttpStatus.SC OK) ( 

21 String resultData - EntityUtils.toString( 

22 httpResponse. getEntity()); 

23 return resultData; 

24 } 

25 } catch (IOException e) { 

26 e. printStackTrace() ; 

27 } 

28 return ""; 

29 } 


04 fifi] NameValuePair 接口 是 一 个 简单 封闭 的 键 值 对 ,只 提供 了 一 个 getName() 和 一 
个 getValue 方法 。 主 要 用 到 的 实现 类 是 BasicNameVaulePair。 

21 行 的 EntityUtils 是 一 个 final 类 ,专门 用 于 处 理 HttpEntity, 常 用 方法 包括 以 下 
几 种 。 

* String getContentCharSet (HttpEntity entity); 设置 HttpEntity 对 象 的 ContentCharset。 

* byte[] toByteArray (HttpEntity entity): 将 HttpClient 转换 成 一 个 字 节 数组 。 

* String toString (HttpEntity entity, String defaultCharset): 通过 指定 的 编码 方式 

取得 HttpEntity 里 字符 串 的 内 容 。 
* String toString (HttpEntity entity): 取得 HttpEntity 里 字符 串 的 内 容 。 


5.3.4 AndroidHttpClient 


android. net. http. AndroidHttpClient 类 是 Google 对 Apache 中 HttpClient 的 一 个 封 
装 , 属 于 Android 原生 的 Http 访问 工具 类 。 

AndroidHttpClient 对 DefaultHttpClient 做 了 一 些 改 进 , 使 其 更 易 用 于 Android 项 目 ， 
包括 以 下 内 容 : 

。 关 掉 过 期 检查 , 自 连接 可 以 打破 所 有 的 时 间 限 制 。 

* 可 以 设置 ConnectionTimeOut( 连 接 超时 ) 和 SoTimeout( 读 取 数 据 超时 ) 。 

。 关 掉 重 定向 。 

。 将 一 个 Session 缓冲 用 于 SSL Sockets。 

。 如 果 服 务 器 支持 ,使 用 gzip 压缩 方式 用 于 在 服务 端 和 客户 端 之 间 传 递 数 据 。 
。 默认 情况 下 不 保留 Cookie。 

使 用 AndroidHttpClient 的 方式 和 DefaultHttpClient 差不多 。 有 一 点 需要 注意 的 是 ， 
AndroidHttpClient 是 一 个 final 类 ,也 没有 公开 的 构造 方法 ,所 以 无 法 使 用 new 的 形式 对 其 
进行 实例 化 ,必须 使 用 AndroidHttpClient. newInstance ( ) 方 法 获得 AndroidHttpClient 
对 象 。 

下 面 的 代码 是 Android SDK 自 带 的 通过 AndroidHttpClient 下 载 图 像 的 示例 : 


01 class BitmapDownloaderTask extends AsyncTask «String, Void, Bitmap? { 
02 private static final int IO BUFFER SIZE = 4 * 1024; 
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03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
4l 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 


private String url; 
private final WeakReference < ImageView > imageViewReference; 


public BitmapDownloaderTask(ImageView imageView) { 
imageViewReference = new WeakReference < ImageView >( imageView) ; 


/ xx 
* Actual download method. 
x/ 
@Override 
protected Bitmap doInBackground(String... params) { 
final AndroidHttpClient client = 
AndroidHttpClient. newInstance("Android") ; 
url = params[0]; 
final HttpGet getRequest = new HttpGet(url); 
String cookie = params[1]; 
if (cookie != null) { 
getRequest. setHeader("cookie", cookie) ; 


try { 
HttpResponse response = client. execute(getRequest) ; 
final int statusCode = response. getStatusLine().getStatusCode( ) ; 
if (statusCode != HttpStatus. SC_OK) { 
Log. w("ImageDownloader", "Error " + statusCode + 
"while retrieving bitmap from" + url); 
return null; 


final HttpEntity entity = response. getEntity(); 
if (entity != null) { 
InputStream inputStream = null; 
OutputStream outputStream = null; 
try { 
inputStream = entity. getContent(); 
final ByteArrayOutputStream dataStream = 
new ByteArrayOutputStream() ; 
outputStream = new BufferedOutputStream(dataStream, 
IO BUFFER SIZE); 
copy(inputStream, outputStream); 
outputStream. flush(); 


final byte[] data = dataStream. toByteArray(); 
final Bitmap bitmap = BitmapFactory. decodeByteArray( 
data, 0, data.length); 


//FIXME : Should use BitmapFactory 
//.decodeStream(inputStream) instead. 
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52 //£inal Bitmap bitmap = BitmapFactory 
53 //. decodeStream( inputStream) ; 

54 

35 return bitmap; 

56 

57 } finally { 

58 if (inputStream != null) { 

59 inputStream. close(); 

60 } 

61 if (outputStream != null) { 

62 outputStream. close( ) ; 

63 } 

64 entity. consumeContent( ) ; 

65 } 

66 } 

67 } catch (IOException e) { 

68 getRequest. abort() ; 

69 Log.w(LOG TAG, "I/O error while retrieving bitmap from " * url, e); 
70 ] catch (IllegalStateException e) ( 

as getRequest. abort( ) ; 

72 Log.w(LOG TAG, "Incorrect URL: " * url); 

73 ) catch (Exception e) { 

74 getRequest. abort() ; 

75 Log.w(LOG TAG, "Error while retrieving bitmap fron" + url, e); 
76 ) finally ( 

yi if (client != null) { 

78 client. close() ; 

79 } 

80 } 

81 return null; 

82 } 

83 

84 / «x 

85 * Once the image is downloaded, associates it to the imageView 
86 */ 


87 @Override 
88 protected void onPostExecute(Bitmap bitmap) { 


89 if (isCancelled()) { 

90 bitmap = null; 

91 } 

92 

93 // Add bitmap to cache 

94 if (bitmap != null) { 

95 synchronized (sHardBitmapCache) { 
96 sHardBitmapCache. put(url, bitmap); 
97 H 

98 } 

99 

100 if (imageViewReference != null) { 
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101 ImageView imageView = imageViewReference.get(); 


102 BitmapDownloaderTask bitmapDownloaderTask - 

103 getBitmapDownloaderTask( imageView); 

104 //Change bitmap only if this process is still associated with it 
105 if (this == bitmapDownloaderTask) { 

106 imageView. setImageBitmap( bitmap) ; 

107 } 

108 } 

109 } 

110 

afte public void copy(InputStream in, OutputStream out) throws IOException { 
112 byte[] b = new byte[IO BUFFER SIZE]; 

13 int read; 

114 while ((read = in.read(b)) != -1) { 

115 out. write(b, 0, read); 

116 } 

u? } 

118 } 


5.4 Http 连接 框架 


目前 ,Android 平台 上 基于 Http 的 连接 框架 有 很 多 种 ,本 节 主 要 介绍 应 用 比较 广泛 的 
android-async-http 框架 和 Volley 框架 。 


5.4.1 android-async-http 框架 


android-async-http? 是 Android 上 的 一 个 异步 HTTP 客户 端 开发 包 , 它 构建 在 
Apache HttpClient 库 之 上 ,所 有 的 请 求 都 在 应 用 程序 的 主线 程 (UI 线程 ) 之 外 执行 ,但 任何 
回调 的 逻辑 都 使 用 Android 的 Handler 消息 传递 机 制 在 同一 线程 中 被 执行 。 

1. 功能 特性 

android-async-http 提供 的 主要 功能 包括 : 

。 进行 异步 HTTP 请 求 ,并 通过 匿名 内 部 类 处 理 回 调 结果 。 
。 HTTP 请 求 发 生 在 UI 线程 之 外 ,不 会 阻塞 UI 操作。 

。 通过 线程 池 处 理 并 发 请 求 。 

* GET/POST 参数 构造 通过 RequestParams 类 完成 。 

。 处 理 文件 的 上 传 、 下 载 。 

* 响应 结果 自动 打包 成 JSON 格式 。 

。 应 用 程序 开销 少 , 仅 仅 25KB 就 可 以 满足 所 有 要 求 。 

。 能 处 理 环行 和 相对 重 定向 。 

。 自动 智能 请 求 重 试 ,优化 了 质量 不 一 的 移动 连接 。 


© 项 目 主页 : http://loopj. com/android-async-http/ . 
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* 自动 的 GZIP 响应 解码 支持 超 快速 的 请 求 。 

。 二 进 制 文件 通过 BinaryHttpResponseHandler Fak. 

。 内 置 响应 通过 JsonHttpResponseHandler 解析 成 JSON. 

。 支持 SAX 解析 器 。 

* 持久 化 Cookie 存储 、 保 存 Cookie 到 应 用 程序 的 SharedPreferences。 

。 支持 各 种 语言 和 content 编码 (不 仅仅 是 UTF-8) 。 

2. 核心 类 

(1) AsyncHttpRequest 

AsyncHttpRequest 继承 A Runnable, 基于 线程 的 子 类 ,用 于 异步 请 求 , 通过 
AsyncHttpResponseHandler 回调 。 

(2) AsyncHttpResponseHandler 

AsyncHttpResponseHandler 接收 请 求 结果 ,一 般 重 写 onSuccess() 及 onFailure() 方 法 
来 接收 请 求 成 功 或 失败 的 消息 ,还 有 onStart() .onFinish() 等 消息 。 

(3) TextHttpResponseHandler 

TextHttpResponseHandler 继承 自 AsyncHttpResponseHandler, H Æ BH S 了 
AsyncHttpResponseHandler 的 onSuccess() 及 onFailure() 方 法 ,将 请 求 结果 由 byte 数组 
转换 为 String。 

(4) JsonHttpResponseHandler 

JsonHttpResponseHandler 继承 自 Text HttpResponseHandler , 同样 是 重 写 onSuccess O & 
onFailureO Jr i£ ,将 请 求 结 果 由 String 转换 为 JSONObject 或 JSONArray。 

(5) BaseJsonHttpResponseHandler 

BaseJsonHttpResponseHandler 继承 自 Text HttpResponseHandler, ft — 47 12 78 26 , 提 
HET parseResponseO Jri£ , 子 类 需要 提供 实现 ,将 请 求 结果 解析 成 需要 的 类 型 , 子 类 可 以 灵 
活 地 使 用 解析 方法 ,可 以 直接 原始 解析 ,或 使 用 gson 等 。 

(6) RequestParams 

RequestParams 为 请 求 参数 ,可 以 添加 普通 的 字符 串 参 数 ,也 可 添加 File, 使 用 InputStream 
上 传 文件 。 

(7) AsyncHttpClient 

AsyncHttpClient 为 核心 类 ,使 用 HttpClient 执行 网 络 请 求 ,提供 了 GET, PUT, 
POST DELETE, HEAD 等 请 求 方法 ,使 用 起 来 很 简单 ,只 需 以 URL 及 RequestParams 调 
用 相应 的 方法 即 可 ,还 可 以 选择 性 地 传人 Context, 用 于 取消 Content 相关 的 请 求 , 同 时 必须 
提供 ResponseHandlerInterface(AsyncHttpResponseHandler 继承 自 ResponseHandler In- 
terface) 的 实现 类 ,一 般 为 AsyncHttpResponseHandler 的 子 类 ,AsyncHttpClient 内 部 有 一 
个 线程 池 , 当 使 用 AsyncHttpClient 执行 网 络 请 求 时 ,最 终 都 会 调用 sendRequest() 方 法 ,在 
这 个 方法 内 部 将 请 求 参数 封装 成 AsyncHttpRequest 并 交 由 内 部 的 线程 池 执行 。 

(8) SyncHttpClient 

SyncHttpClient 继承 自 AsyncHttpClient, 同 步 执行 网 络 请 求 ,AsyncHttpClient 把 请 求 封装 
成 AsyncHttpRequest 后 提交 至 线程 池 ,SyncHttpClient 把 请 求 封装 成 AsyncHttpRequest 后 直 
接 调用 它 的 run() 方 法 。 
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3. 请 求 步骤 
使 用 android-async-http 的 一 般 步 又 如 下 。 
(D 创建 一 个 AsyncHttpClient。 下 面 的 代码 是 一 个 使 用 AsyncHttpClient 的 典型 


框架 。 


01 RsyncHttpClient client = new AsyncHttpClient(); 
02 client.get(httpUrl, new AsyncHttpResponseHandler() { 


03 
04 
05 
06 
07 
08 
09 
10 
it 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 


@Override 
public void onStart() { 

//called before request is started 
} 


@Overr ide 
public void onSuccess(int statusCode, Header[ ] headers, 
byte[ ] response) { 
//called when response HTTP status is "200 OK" 
h 


@Override 
public void onFailure(int statusCode, Header[ ] headers, 
byte[] errorResponse, Throwable e) ( 


// called when response HTTP status is "4XX" (eg. 401, 403, 404) 


} 


@Override 

public void onRetry(int retryNo) { 
//called when request is retried 

} 


n; 


© (可 选 的 ) 通 过 RequestParams 对 象 设置 请 求 参数 。 例 如 : 


01 RequestParams params = new RequestParams(); 
02 params. put("username", userName) ; 
03 params. put("userpass", userPass) ; 


© 调用 AsyncHttpClient 的 get 或 post 等 方法 发 起 网 络 请 求 。 例 如 : 


01 mAsyncHttpClient.post(url, params, new AsyncHttpResponseHandler() {}); 


@ 所 有 的 请 求 都 在 sendRequest 中 被 封装 为 AsyncHttpRequest, 并 添加 到 线程 池 


执行 。 


© 当 请 求 被 执行 时 ( 即 AsyncHttpRequest 的 run() 方 法 ) ,执行 AsyncHttpRequest 的 
makeRequestWithRetries() 方 法 执行 实际 的 请 求 , 当 请 求 失败 时 可 以 重 试 。 并 在 请 求 开 始 、 


结束 、 成 功 或 失败 时 向 请 求 时 传人 的 ResponseHandlerInterface 实例 发 送 消息 。 
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© 使 用 AsyncHttpResponseHandler 的 子 类 并 调用 其 onStart O .onSuccess() 等 方法 
返回 请 求 结果 。 
下 面 的 downloadImage() 方 法 演示 了 使 用 android-async-http 框架 的 典型 用 法 。 


01 private void downloadImage(String url) { 


02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 


AsyncHttpClient client - new AsyncHttpClient(); 
client.get(url, new AsyncHttpResponseHandler() ( 


n; 


@Override 
public void onSuccess(int statusCode, Header[ ] headers, 
byte[] responseBody) ( 
if (statusCode == 200) ( 
BitmapFactory factory = new BitmapFactory(); 


Bitmap bitmap = factory. decodeByteArray(responseBody, 0, 


responseBody. length) ; 
imageView. setImageBitmap( bitmap) ; 


} 


@Override 
public void onFailure(int statusCode, Header[ ] headers, 
byte[] responseBody, Throwable error) { 
error. printStackTrace( ) ; 


5.4.2 Volley 框架 


Volley? 是 Google 工程 师 Ficus Kirpatrick 在 Gooogle I/O 2013 发 布 的 一 个 处 理 和 组 
存 网 络 请 求 的 库 ,内 部 使 用 了 HttpURLConnection 和 HttpClient@ 网 络 连 接 ,能 使 网 络 通 


信 更 快 、 更 简单 更 健壮 。 
1. 功能 特性 


Volley 适合 传输 数据 量 不 大 ,但 通信 频繁 的 网 络 操作 ,特别 是 针对 JSON 对 象 和 图 像 加 
载 的 应 用 。 


Volley 提供 的 主要 特性 包括 : 


封装 了 异步 的 RESTful9 请 求 API; 
请 求 队列 的 优先 级 排序 ; 
认证 头 部 管理 ; 

一 个 可 扩展 的 架构 , 它 使 开发 人 员 能 够 实现 自 定义 的 请 求 和 响应 处 理 机 制 ; 


© 源码 下 载 地 址 : git clone https://android. googlesource. com/platform/frameworks/volley 


OQ Android 2.3 之 前 的 版 本 ,建议 使 用 Apache 的 HttpClient 来 处 理 网 络 请 求 , 2. 3 之 后 的 版 本 建议 使 用 
HttpUrlConnection。 博 文 参 见 : http://android-developers. blogspot. com/2011/09/androids-http-clients. html, 


RESTful 是 一 种 软件 架构 风格 ,提供 了 一 组 设计 原则 和 约束 条 件 , 它 主要 用 于 客户 端 和 服务 器 交互 类 的 软件 , 基 


o 


于 这 个 风格 设计 的 软件 可 以 更 简洁 ,更 有 层次 .更 易于 实现 缓存 等 机 制 。 
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能 够 使 用 外 部 HTTP Client 库 ; 
。 透明 的 缓存 策略 ; 
UI 线程 可 更 新 ; 
。 提供 了 调试 和 跟踪 工具 ,并 可 以 在 UI 线程 提示 请 求 过 程 中 出 现 的 错误 ; 
。 自 定义 的 网 络 图 像 加 载 视图 (如 NetworkImageView、ImageLoader 55) ; 
Volley 可 以 绑 定 Content 的 生命 周期 ,例如 当 Activity 销毁 时 ,Volley 可 以 取消 响 
应 的 网 络 请 求 。 
2. Volley 架构 
Volley 使 用 线程 池 来 作为 基础 结构 ,主要 分 为 主线 程 .Cache 线程 和 Network 线程 。 
主线 程 和 Cache 线程 都 只 有 一 个 ,而 NetworkDispatcher 线程 可 以 有 多 个 ,这 样 能 解决 并 行 
问题 。 5-1 的 Volley 体系 框架 节选 自 Ficus Kirpatrick 在 Google 会 议 上 的 演讲 。 
Request added to 


cache queue in 
priority order 











Parsed response 
delivered on main 
thread. 







Response read from 


cache and parsed 






main thread. 


图 5-1 Volley 体系 架构 





3. Volley 处 理 流 程 

Volley 一 个 很 大 的 特色 ,就 是 所 有 的 网 络 请 求 无 须 开 发 者 自己 执行 ,而 是 在 请 求 构造 
完成 后 传递 到 Volley 的 请 求 队列 中 ,队列 依次 进行 请 求 , 开 发 者 不 用 担心 网 络 请 求 是 否 会 
冲突 ,是 否 会 在 主线 程 ,从 而 提高 了 开发 效率 。 

Volley 的 基本 处 理 流程 如 图 5-2 所 示 。 

(1) 应 用 初始 化 Volley。 

Volley 是 一 个 Helper 类 , 主要 负责 创建 请 求 队列 ,并且 启动 队列 消息 的 循环 。 

(2) Volley 创建 一 个 RequestQueue, NetworkDispatcher 组 及 Network. 

RequestQueue 即 一 个 Request 队列 ,RequestQueue 会 创建 一 个 ExecutorDelivery。 

RequestQueue 是 一 个 请 求 队列 对 象 , 它 可 以 缓存 所 有 的 HTTP 请 求 , 然 后 按照 一 定 的 
算法 并 发 地 发 出 这 些 请 求 。RequestQueue 内 部 的 设计 非常 适合 高 并 发 应 用 ,程序 不 必 为 每 
一 次 HTTP 请 求 都 创建 一 个 RequestQueue 对 象 (基本 上 在 每 一 个 需要 和 网 络 交互 的 
Activity 中 创建 一 个 RequestQueue 对 象 就 足够 了 )。 
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postResponse 
图 5-2 Volley 处 理 流程 
RequestQueue 申请 方法 的 一 般 形式 为 : 


01 if (mRequestQueue == null) ( 
02 mRequestQueue = Volley. newRequestQueue( getApplicationContext()); 
03 ] 


当 一 个 RequestQueue 被 成 功 申请 后 会 开启 一 个 CacheDispatcher CX ££ ifi] EE #8) Al 4 个 
(默认 )NetworkDispatcher( 网 络 请 求 调度 器 )。CacheDispatcher 为 第 一 层 缓冲 ,开始 工作 
后 阻塞 从 缓存 序列 mCacheQueue 中 取得 以 下 请 求 : 
。 对 于 已 经 取消 了 的 请 求 ,直接 标记 为 跳 过 并 结束 这 个 请 求 。 
* 对 于 全 新 或 过 期 的 请 求 ,直接 丢人 mNetworkQueue 中 交 由 NetworkDispatcher if 
行 处 理 。 

。 已 获得 缓存 信息 (网 络 应 答 ) 且 没有 过 期 的 请 求 , 交 由 Request 的 parseNetworkRe- 
sponse 进行 解析 ,从 而 确定 此 应 答 是 否 成 功 。 然 后 将 请 求 和 应 答 交 由 Delivery 分 发 
者 进行 处 理 ,如 果 需 要 更 新 缓存 ,那么 该 请 求 还 会 被 放 和 人 mNetworkQueue 中 。 

(3) NetworkDispatcher 负责 网 络 调度 (实质 是 Thread 线程 池 ) ,从 RequestQueue 中 取 
Request, 通 过 Network 加 以 执行 。 

Volley 提供 了 JsonObjectRequest、JsonArrayRequest、StringRequest 等 Request 形式 。 

。 JsonObjectRequest: 返回 JSON 对 象 。 

* JsonArrayRequest: 返回 JsonArray。 

* StringRequest: 返回 String。 

另外 ,可 以 通过 继承 Request T^ 3€ BE X. Request. 

FAP Request 添加 到 RequestQueue 之 后 ,还 需 做 以 下 事情 。 

。 对 于 不 需要 缓存 的 请 求 (需要 额外 设置 ,默认 是 需要 缓存 ) 直 接 丢 和 人 mNetworkQueue 

交 由 NetworkDispatcher 处 理 。 
* 对 于 需要 缓存 的 全 新 的 请 求 , 则 加 入 mCacheQueue 中 给 CacheDispatcher 处 理 。 
。 需要 缓存 但 是 缓存 列表 中 已 经 存在 了 相同 URL 的 请 求 , 则 放 在 mWaitingQueue 中 
做 暂时 保管 , 待 之 前 的 请 求 结束 后 ,再 重新 添加 到 mCacheQueue 中 。 
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下 面 是 一 个 StringRequest 的 示例 : 


01 StringRequest req = new StringRequest(URL, 


02 new Response. Listener < String>() { 

03 @Override 

04 public void onResponse(String response) { 

05 VolleyLog. v("Response: $n %s", response); 
06 } 

07 ) 

08 new Response. ErrorListener() { 

09 @Override 

10 public void onErrorResponse(VolleyError error) { 
11 VolleyLog. e("Error: ", error.getMessage()); 

12 } 


13 }); 


(4) Network 负责 网 络 请 求 的 处 理 ,具体 过 程 交 给 HttpStack AM., Network 封装 了 
HttpStack 的 网 络 请 求 ,PerformRequest 方法 直接 返回 一 个 NetworkResponse, 处 理 请 求 异 
常 并 抛 出 VolleyError。 

HttpStack 分 HttpURLConnection 与 HttpClient 两 种 方式 。HttpStack 负责 解析 网 络 
请 求 , PerformRequest 返回 一 个 Apache 的 HttpResponse, 确保 返回 的 Response 有 
StatusLine。 

ExecutorDelivery 负责 处 理 请 求 结果 ,并 与 主线 程 进行 交互 。Delivery 实际 上 已 经 是 对 
网 络 请 求 处 理 的 最 后 一 层 了 ,在 Delivery 对 请 求 处 理 之 前 ,Request 已 经 对 网 络 应 答 进 行 过 
解析 ,此 时 应 答 成 功 与 和 否 已 经 设 定 。 而 后 Delivery 会 根据 请 求 所 获得 的 应 答 情况 做 以 下 的 
不 同 处 理 ， 

。 若 应 答 成 功 , 则 触发 deliverResponse 方法 ,最 终 会 触发 开发 者 为 Request 设 定 的 


Listener, 
。 若 应 答 失 败 , 则 触发 deliverError 方法 , 最终 会 触发 开发 者 为 Request 设 定 的 
ErrorListener。 


(5) 取消 Request。 

如 果 在 结束 Activity 时 ,其 中 启动 的 网 络 请 求 还 没有 返回 结果 ,需要 手动 取消 所 有 或 部 
分 未 完成 的 网 络 请 求 。Volley 里 所 有 的 请 求 结果 会 返回 给 主 进程 ,如 果 在 主 进 程 里 取消 了 
某 些 请 求 , 则 这 些 请 求 将 不 会 被 返回 给 主线 程 。Volley 支持 多 种 Request 取消 方式 。 

* 针对 某 些 Request 做 取消 操作 ,例如 : 


01 @Override 

02 public void onStop() { 

03 for (Request <?> req : mRequestQueue) { 
04 req. cancel(); 

05 } 

06 } 
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* 取消 这 个 队列 里 的 所 有 请 求 , 例 如 : 


01 @Override 

02 protected void onStop() { 

03 super. onStop() ; 

04 mRequestQueue. cancelAll(this); 
05 ] 


* 根据 RequestFilter 或 者 Tag 来 终止 某 些 请 求 , 例 如: 


01 @Override 
02 protected void onStop() { 


03 super. onStop() ; 
04 mRequestQueue.cancelAll( new RequestFilter() (]); 
05 } 


4. 使 用 Volley 异步 加 载 图 像 
(D ImageRequest 
ImageRequest 能 够 处 理 单 张 图 像 ,返回 Bitmap 对 象 。ImageRequest 的 构造 方法 如 下 : 


01 ImageRequest(String url, Response. Listener <Bitmap > listener, int maxWidth, 
02 int maxHeight, Config decodeConf ig, 
03 Response. ErrorListener errorListener) 


第 一 个 参数 就 是 图 像 的 URL 地 址 。 第 二 个 参数 是 图 像 请 求 成 功 的 回调 。 第 三 、 第 四 
个 参数 分 别 用 于 指定 允许 图 像 最 大 的 宽度 和 高 度 , 如 果 指 定 的 网 络 图 像 的 宽度 或 高 度 大 于 
这 里 的 最 大 值 , 则 会 对 图 像 进行 压缩 ,指定 成 0 就 表示 不 管 图 像 有 多 大 ,都 不 会 进行 压缩 。 
第 五 个 参数 用 于 指定 图 像 的 颜色 属性 ,Bitmap. Config 下 的 几 个 常量 都 可 以 在 这 里 使 用 ,其 
中 ARGB_8888 可 以 展示 最 好 的 颜色 属性 ,每 个 图 像 像素 占据 4 个 字 节 大 小 ,而 RGB_565 
则 表示 每 个 图 像 像素 占据 2 个 字 节 大 小 。 第 六 个 参数 是 图 像 请 求 失败 的 回调 。 

下 面 是 ImageRequest 的 使 用 示例 : 


01 singleImg = (ImageView)findViewById(R. id.volley img single imgeview); 
02 ImageRequest imgRequest = new ImageRequest(url, 


03 new Response. Listener <Bitmap >() { 

04 @Override 

05 public void onResponse(Bitmap arg0) { 
06 singleImg. setImageBitmap(arg0) ; 
07 } 

08 Lh 

09 maxWidth, maxHeight, Config. ARGB 8888, 

10 new ErrorListener() { 

11 @Override 

12 public void onErrorResponse(VolleyError arg0) { 
13 } 

14 J; 


15 mRequestQueue. add(imgRequest) ; 
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(2) ImageLoader 

ImageLoader 类 (内 部 也 是 使 用 ImageRequest 来 实现 ) 需 要 一 个 Request 的 实例 以 及 
一 个 ImageCache 的 实例 。 图 像 通 过 一 个 URL 和 一 个 ImageListener 实例 的 get() 方 法 来 
加 载 。ImageLoader 会 检查 ImageCache ,如果 缓 存 里 没有 图 像 , 就 会 从 网 络 上 获取 。 因 此 ， 
ImageLoader 明显 要 比 ImageRequest 更 加 高 效 , 因 为 它 不 仅 可 以 对 图 像 进行 缓存 ,还 可 以 
过 滤 掉 重复 的 链接 ,避免 重复 发 送 请 求 。 

Volley 的 ImageCache 接口 允许 使 用 L1 缓存 实现 ,用 户 可 以 根据 需要 自行 定义 。 
ImageCache 接口 有 两 个 方法 , 即 getBitmap(String url) 和 putBitmap(String url, Bitmap 
bitmap) 来 实现 缓存 机 制 。 例 如 : 


01 RequestQueue mRequestQueue = Volley.newRequestQueue(this); 

02 LruCache< String, Bitmap? mImageCache = new LruCache «String, Bitmap>(20); 
03 

04 ImageCache imageCache = new ImageCache() { 

05 @Override 

06 public void putBitmap(String key, Bitmap value) { 

07 mImageCache. put(key, value); 

08 } 

09 

10 @Override 

EI public Bitmap getBitmap(String key) ( 

12 return mImageCache. get (key); 

13 } 

14 }; 

15 

16 ImageLoader mImageLoader = new ImageLoader(mRequestQueue, imageCache); 
17 ImageListener listener = ImageLoader. getImageListener( 

18 imageView, android. R.drawable.ic menu rotate, 

19 android.R.drawable. ic delete); 

20 mImageLoader.get(url, listener); 


(3) NetworkImageView 
NetworkImageView 4k 7K 4 ImageView, & Volley 提供 的 一 个 全 新 的 .简单 加 载 图 像 
的 控件 。 下 面 是 一 个 在 布局 中 使 用 的 示例 : 


01 <com. android. volley. toolbox. NetworkImageView 


02 android:id- "(8 + id/network image view" 

03 android:layout width = "200dp" 

04 android:layout height - "200dp" 

05 android: layout_gravity = "center horizontal" 
06 /> 


在 Activity 中 绑 定 了 NetworkImageView 对 象 后 ,可 以 设置 一 些 相关 的 属性 ,例如 : 
01 networkImageView.setDefaultImageResId(R. drawable. default image); 
02 networkImageView. setErrorImageResId(R. drawable. failed image); 


03 networkImageView.setlmageUrl(url, imageLoader); 
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setImageUrl() 方 法 的 第 一 个 参数 用 于 指定 图 像 的 URL 地 址 ,第 二 个 参数 则 是 前 面 创 
建 好 的 ImageLoader 对 象 ( 其 实 NetworkImageView 控件 和 用 ImageLoader 加 载 图 像 的 性 
质 是 一 样 的 ) 。 


5,5 3 题 


l. 编程 实现 从 网 络 下 载 一 幅 图 像 并 保存 到 SD 卡 中 。 
2. 编程 实现 使 用 Volley 从 网 络 异步 下 载 多 幅 图 像 并 以 列表 样式 显示 。 
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Web App 无 须 安装 ,对 设备 碎片 化 的 适应 能 力 优 于 Native App, 它 只 需要 通过 
HTML,CSS 和 JavaScript 就 可 以 在 任意 移动 浏览 器 中 执行 。 随 着 WebKit 浏览 体验 的 升 
级 ,使 得 支持 WebKit 浏览 内 核 的 移动 设备 开发 的 Web App 也 有 了 类 似 Native App 一 样 
流畅 的 用 户 体验 。 


6.1 访问 Web 页 面 


在 Android 中 ,有 两 种 浏览 Web 网 页 的 方法 。 


6.1.1 通过 Intent 浏览 Web 页 面 


Android 中 提供 了 Intent 机 制 来 协助 应 用 之 间 的 交互 与 通信 ,Intent 负责 对 应 用 中 一 
次 操作 的 动作 ,动作 涉及 的 数据 以 及 附加 数据 等 信息 进行 描述 。Android 则 根据 此 Intent 
的 描述 ,负责 找到 对 应 的 组 件 ,将 Intent 传递 给 调用 的 组 件 ,并 完成 组 件 的 调用 。 因 此 ， 
Intent 相当 于 应 用 程序 之 间 的 通信 网 络 ,是 对 执行 某 个 操作 的 一 种 抽象 描述 。 

下 面 的 代码 演示 了 通过 隐 式 Intent 在 浏览 器 中 访问 Google 主页 的 方法 : 


01 Uriuri = Uri.parse("http://www. google.com") ; 
02 Intent intent - new Intent(Intent.ACTION VIEW, uri); 
03 startActivity(intent); 


01 行 通过 Uri. parse() 方 法 将 表示 网 址 的 字符 串 格式 化 ,02 行 构建 了 一 个 隐 式 的 
Intent, 其 中 的 ACTION. VIEW 是 设置 Intent 的 动作 ,多 用 于 处 理 未 知 文件 类 型 的 打开 。 
03 行 通过 调用 startActivity() 方 法 将 Intent 发 布 成 一 个 任务 ,可 以 不 用 确切 知道 哪个 应 用 
程序 组 件 将 会 去 执行 该 任务 ,只 要 关心 该 任务 是 否 被 执行 .是 否 按照 要 求 完 成 就 够 了 , 剩 下 
的 细节 由 系统 自动 去 完成 。 

当 隐 式 的 Intent 被 抛 出 后 ,系统 在 众多 组 件 中 根据 Intent 过 滤器 中 的 action, datatype, 
uri 来 寻找 与 其 匹配 的 处 理 方法 。 如 果 存 在 多 个 结果 ,用 户 可 以 根据 需要 选择 合适 的 处 理 
Jk. 

最 后 ,需要 在 AndroidManifest. xml 中 添加 如 下 访问 网 络 的 权限 : 


«uses — permission android: name = "android. permission. INTERNET" /> 


图 6-1 显示 了 通过 隐 式 的 Intent 访问 Web 页 面 的 效果 。 
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图 6-1 AVD 中 的 浏览 器 


6.1.2 通过 WebView 浏览 Web 页 面 


WebView 是 Android 的 View 类 的 子 类 ,可 以 在 Activity Hi Ja Pim A— ^^ WebView 
组 件 来 显示 一 个 网 页 。 下 面 介绍 WebView 的 基本 使 用 。 
在 项 目的 Res/layout 中 创建 一 个 包含 WebView 控件 的 布局 文件 ,代码 如 下 : 


01 <?xml version = "1.0" encoding = "utf - 8"?> 

02 <WebView xmlns:android- "http://schemas. android. com/apk/res/android" 
03 android:id- "@ + id/webview" 

04 android:layout width- "fill parent" 

05 android:layout height- "fill parent" /> 


TE Activity 的 onCreate() 生 命 周 期 方法 中 通过 setContentView() 方 法 载 人 上 面包 含 
WebView 的 布局 ,并 绑 定 其 中 的 WebView 控件 ,代码 如 下 : 

01 private WebView webview; 

02 


03 webview - (WebView) findViewById(R. id. webview); 
04 webview. loadUrl("http://www. google. com") ; 


04 行使 用 loadUrl() 方 法 载 入 网 页 。 
最 后 ,也 需要 在 AndroidManifest. xml 中 添加 如 下 访问 网 络 的 权限 : 


<uses — permission android: name = "android. permission. INTERNET" /> 


程序 的 运行 结果 类 似 图 6-1。 
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6.2 WebKit 与 WebView 


本 节 介 绍 WebKit 和 WebView 的 基本 知识 。 


6.2.1 WebKit 浏览 器 引擎 


WebKit? 是 一 个 开源 的 浏览 器 引擎 ,包含 一 个 网 页 引擎 WebCore 和 一 个 脚本 引擎 
JavaScriptCore。Android 平台 的 Web 引擎 框架 采用 了 WebKit 项 目 中 的 WebCore 和 
JavaScriptCore 部 分 ,上 层 由 Java 语言 封装 ,并 且 作 为 API 提供 给 Android 应 用 开发 者 ,而 
底层 使 用 WebKit 核心 库 (WebCore 和 JSCore) 进行 网 页 排版 。Android 平台 架构 的 
WebKit 如 图 6-2 所 示 。 


应 用 部 分 
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6-2 Android 平台 架构 


©  Webkit 官网 : http://www. webkit. org/ . 
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Android 平台 的 WebKit 由 Java 层 和 WebKit 库 两 部 分 组 成 ,Java 层 负责 与 Android 
应 用 层 进行 通信 ,而 WebKit 类 库 负责 实际 的 网 页 排版 处 理 。Android SDK 中 提供 了 
android. webkit. WebView 类 , 它 继 承 自 View 类 ,为 客户 提供 客户 化 浏览 显示 的 功能 ,如 果 
客户 需要 加 入 浏览 器 支持 ,可 将 该 类 的 实例 或 者 派生 类 的 实例 作为 视图 ,调用 Activity 类 的 
setContentView() 方 法 显示 给 用 户 。 当 客户 代码 中 第 一 次 生成 WebView 对 象 时 ,会 初始 化 
WebKit 库 ( 包 括 Java 层 和 C 层 两 个 部 分 ), 之 后 用 户 可 以 操作 WebView 对 象 完 成 网 络 或 
者 本 地 资源 的 访问 。 

WebKit 工作 在 两 个 线程 中 ,一 个 是 UI 线程 ,也 就 是 应 用 程序 使 用 WebView 所 在 的 主 
线程 ; 另 一 个 是 WebCore 线程 。WebView 的 消息 处 理 ,主要 是 UI 线程 和 WebCore 线程 
的 交互 。 一 部 分 UI 线程 向 WebCore 发 送 命令 操作 的 消息 ,例如 LOAD_URL; 另 一 部 分 是 
来 自 UI 的 触摸 消息 。 

从 Android 4.4 Kitkat 版 本 开始 ,原本 基于 Android WebKit 的 WebView 实现 被 换 成 
基于 Chromium( 基 于 webkit 内 核 ) 的 WebView 实现 。Chromium 是 Google 的 Chrome 浏 
览 器 背后 的 引擎 ,其 目的 是 为 了 创建 一 个 安全 、 稳 定 和 快速 的 通用 浏览 器 。 

Chromium 是 一 个 由 Google 主导 开发 的 网 页 浏览 器 。 以 BSD 许可 证 等 多 重 自由 版 权 
发 行 并 开放 源 代码 。Chromium 的 设计 思想 基于 简单 、 高 速 、 稳 定 、 安 全 等 理念 ,在 架构 上 使 
用 了 Apple 发 展 出 来 的 WebKit 排版 引擎 .Safari 的 部 分 源 代码 与 Firefox 的 成 果 , 并 采用 
Google 独家 开发 出 的 V8 引擎 以 提升 编译 JavaScript 的 效率 ,而 且 设 计 了 “ 沙 盒 ”“ 黑 名 单 ” 
“无 痕 浏 览 ?等 功能 来 实现 稳定 与 安全 的 网 页 浏览 环境 。 

Chromium 的 主要 特性 包括 以 下 几 种 。 

。 支持 更 多 的 HTML5 特性 。 例 如 Web Socket, Web Worker, FileSystem API, Page 
Visibility API,CSSfilter 等 。 
添加 了 对 远程 调试 功能 的 支持 。 任 何 使 用 WebView 的 应 用 程序 默认 都 开启 了 远程 
调试 功能 , 通过 USB 线 连接 到 开发 主机 上 ,在 主机 的 Chrome 浏览 器 中 输入 
chrome: //inspect 就 可 以 在 开发 主机 上 直接 调试 WebView 加 载 的 页 面 。 开 发 者 也 
可 以 调用 setWebContentsDebuggingEnabled 开启 或 关闭 这 个 功能 。 

更 智能 的 内 存 管理 策略 。 旧 版 WebView 需要 应 用 程序 在 系统 内 存 不 足 的 情况 下 ， 
显 式 地 调用 freeMemory() 方 法 来 释放 WebView 占用 的 内 存 资源 。 而 新 版 的 
WebView 中 ,freeMemory() 这 个 方法 已 经 被 标记 为 deprecated, 也 就 是 应 用 程序 不 
需要 自己 去 释放 内 存 , WebView 的 内 部 实现 已 经 考虑 了 对 系统 低 内 存 运行 时 的 响 
应 ,一 旦 发 现 系统 处 于 低 内 存 的 运行 状态 , WebView 会 主动 调整 内 存 分 配 策略 , 尽 
可 能 释放 一 些 已 占用 的 内 存 资源 。 

支持 软件 浑 染 和 硬件 加 速 模式 。Android 应 用 程序 可 以 在 AndroidManifest 文件 中 
指定 hardwareAccelerated 的 值 表 明 是 否 启 动 硬件 加 速 , 为 了 兼容 早期 使 用 
WebView 的 应 用 程序 ,新 版 WebView 同时 支持 软件 泻 染 和 硬件 泻 染 两 种 模式 。 


6.2.2 WebView 核心 方法 


WebView 是 一 种 嵌入 式 的 编程 接口 ,能 够 提供 Java 接口 给 开发 者 来 使 用 该 模块 泻 染 
网 页 。 现 在 的 WebView 只 是 一 个 接口 类 ,通过 一 些 内 部 设计 的 改变 ,其 具体 的 实现 可 以 在 
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之 前 的 Android WebKit 和 Chromium 之 间 进 行 切 换 。 新 的 Chromium 实现 专注 于 提供 一 
致 性 的 接口 (为 了 兼容 以 前 的 应 用 ) ,而 内 部 的 泻 染 引擎 改 为 使 用 基于 Blink/Content 内 核 
的 引擎 ,这 种 实现 不 管 是 从 功能 上 还 是 性 能 来 讲 , 都 带 来 巨大 的 提升 。 

WebView 的 核心 方法 包括 以 下 几 种 。 

1. 页 面 加 载 方法 

(1) public void loadData(String data, String mimeType, String encoding) 

作用 : 加 载 指定 的 data 数据 。 

参数 说 明 如 下 。 

* data; String 类 型 的 数据 ,可 以 通过 base64 编码 实现 。 

* mineType: data 数据 的 MIME 类 型 i^ text/html", 

* encoding: data 数据 的 编码 格式 。 

说 明 : 

(D Javascript 有 同 源 限制 , 同 源 策略 限制 了 一 个 源 中 加 载 文 本 或 者 脚本 与 来 自 其 他 源 
中 的 数据 交互 方式 。 要 避免 这 种 限制 可 以 使 用 loadDataWithBaseURL() 方 法 。 

© encoding 参数 指定 data 参数 是 否 为 base64 或 者 URL 编码 ,如 果 data 是 base64 编 
码 , 那 么 encoding 必须 填写 为 base64。 

(2) public void loadUrl(String url) 

作用 : 加 载 指定 url 的 网 页 内 容 。 

(3) public void loadUrl(String url, Map- String. String> additionalHttp Headers) 

作用 : 加 载 指定 url 并 携带 http header 数据 。 

WebView 的 loadUrl() 方 法 除了 可 以 加 载 网 页 ,还 可 以 实现 如 下 功能 。 

CD 打开 本 包 内 asset 目录 下 的 index. html 文件 。 


01 webView.loadUrl(" file:///android asset/index. html ") 


© 打开 本 地 SD 卡 内 的 index. html 文件 。 


01 webView.loadUrl("content://com. android. htmlfileprovider/sdcard/" + 
02 "index. html"); 


© 直接 载 人 HTML 字符 串 。 


01 String htmlString = "<hl>Title</hl ><p>This is HTML text «br />" + 
02 "< i» Formatted in italics </i ><br /> Anothor Line </p>"; 
03 webView.loadData(htmlString, "text/html", "utf- 8"); 


(4) public void reload C) 

作用 : 页 面 所 有 资源 都 会 重新 加 载 。 
(5) public void stopLoading() 
作用 : 停止 加 载 页 面 。 
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2. 页 面 导航 方法 

(1) public void goBackO „public void goForwardO „public void goBackOrForward(int steps) 

作用 : 3 个 方法 以 当前 的 index 为 起 始点 前 进 或 者 后 退 到 历史 记录 中 指定 的 steps, lll 
果 steps 为 负数 , 则 后 退 ; 正 数 则 前 进 。 

(2) public boolean canGoForward() .public boolean canGoBack() 

作用 : 两 个 方法 用 于 设置 是 否 允 许 页 面前 进 或 后 退 。 

3. JavaScript 操作 方法 

(1) public void addJavascriptInterface( Object object, String name) 

作用 : 当 网 页 需要 和 App 进行 交互 时 ,可 以 注入 Java 对 象 提供 给 JavaScritp 调用 。 
Java 对 象 提供 相应 的 方法 供 JavaScript 使 用 。 

说 明 : Android 4. 2 以 下 版 本 使 用 这 个 API 会 涉及 JavaScript 的 安全 问题 ,Javascript 
可 以 通过 反射 这 个 Java 对 象 的 相关 类 进行 攻击 。 

Android 4. 2 及 其 以 上 系统 需要 给 提供 JavaScript 调用 的 方法 前 加 入 一 个 注解 为 
@JavaScriptInterface。 在 虚拟 机 当中 Javascript 调用 Java 方法 时 会 检测 这 个 注解 ,如 果 方 
法 被 标识 , 则 Javascript 可 以 成 功 调用 这 个 Java 方法 ,否则 调用 不 成 功 。 

例如 : 


01 class JsObject ( 

02 (QJavascriptInterface 

03 public String toString() { return "injectedObject"; } 
04 ) 


06 webView. addJavascriptInterface(new JsObject(), "injectedObject"); 


(2) public void evaluateJavascript(String script, ValueCallback<String> resultCallback) 

作用 : 这 个 方法 在 Android 4.4 系统 中 引入 ,因此 只 能 在 Android 4. 4 系统 中 才能 使 
用 ,其 用 于 在 当前 页 面 显示 上 下 文中 异步 执行 的 Javascript 代码 。 

说 明 : 这 个 方法 必须 在 UI 线程 调用 ,这 个 方法 的 回调 也 会 在 UI 线程 执行 。Android 
4.4 以 下 通过 WebView 提供 的 loadUrl 方法 调用 ,如 : 


01 webView.loadUrl("javascript:alert( injectedObject. toString())"); 


3 P javascript 是 执行 Javascript 代码 的 标识 ,后 面 是 Javascript 语句 。 

(3) public void removeJavascriptInterface(String name) 

作用 : 删除 addJavascripInterface O) H} X} WebView 注入 Java 对 象 。 此 方法 在 不 同 
Android 系统 的 WebView 中 会 有 问题 ,会 存在 失效 情况 。 

4. 网 页 查找 功能 

(1) public void findAllAsync(String find) 

作用 : 异步 执行 查找 网 页 内 包含 的 字符 并 设置 为 高 亮 显示 ,查找 结果 会 回调 。 

(2) public int findAll(String find) 

说 明 : 这 个 API Æ Android 4. 1 中 已 经 被 删除 。Android 4. 1 以 上 系统 使 用 findAllAsyncO 
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(3) public void findNext(boolean forward) 
作用 : 查找 下 一 个 匹配 的 字符 。 


例如 : 

01 public class TestFindListener implements 

02 android. webkit. WebView. FindListener { 

03 private FindListener mFindListener; 

04 

05 public TestFindListener(FindListener findListener) { 
06 mFindListener - findListener; 

07 ) 

08 


09 @Overr ide 
10 public void onFindResultReceived( int activeMatchOrdinal, 


1t int numberOfMatches, boolean isDoneCounting) ( 

12 mF indListener. onFindResultReceived(activeMatchOrdinal, 
13 numberOfMatches, isDoneCounting) ; 

14 } 

2500) 

16 


17 public void findAllAsync(String searchString) { 
18 if (android. os. Build. VERSION CODES. JELLY BEAN <= Build. VERSION. SDK_INT) 


19 mWebView.findAllAsync(searchString); 

20 else ( 

21 int number = mWebView. f indAll(searchString); 

22 if (mIKFindListener != null) 

23 mIKFindListener. onFindResultReceived( number); 
24 fixedFindAllHighLight(); 

25 H 

26 } 

27 


28 mWebView. findNext (forward) ; 


5. 数据 清除 部 分 

(1) public void clearCache(boolean includeDiskFiles) 

作用 : 清除 网 页 访问 留 下 的 缓存 ,由 于 内 核 缓 存 是 全 局 的 ,因此 ,这 个 方法 不 是 针对 
WebView, 而 是 针对 整个 应 用 程序 。 

(2) public void clearFormData() 

作用 : 仅仅 清除 自动 完成 填充 的 表单 数据 ,并 不 会 清除 Web View 存储 到 本 地 的 数据 。 

(3) public void clearHistory() 

作用 : 清除 当前 WebView 访问 的 历史 记录 ,只 会 清除 当前 页 之 前 的 历史 记录 。 为 了 解 
决 clearHistory() 的 失效 问题 ,在 调用 loadUrl() 方 法 后 ,一 般 采 用 如 下 方法 : 


01 mWebView. postDelayed(new Runnable() { 
02 @Override 
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03 public void run() { 

04 mWebView.clearHistory(); 
05 } 

06 }, 1000); 


(4) public void clearMatches() 

作用 : 清除 网 页 查找 的 高 亮 匹配 字符 。 

6. WebView 的 状态 

(1) public void onResume() 

作用 : 激活 WebView 为 活跃 状态 ,能 正常 执行 网 页 的 响应 。 

(2) public void onPause() 

作用 : 当 页 面 失去 焦点 被 切换 到 后 台 不 可 见 状态 时 ,需要 执行 onPause() 方 法 ,该 方法 
会 通知 内 核 暂停 所 有 的 动作 ,比如 DOM 的 解析 、plugin 的 执行 JavaScript 的 执行 。 并 且 可 
以 减少 不 必要 的 CPU 和 网 络 开销 ,可 以 达到 省 电 、 省 流量 、 省 资源 的 效果 。 

(3) public void destroy() 

作用 : 这 个 方法 必须 在 WebView 从 view tree 中 删除 之 后 才能 被 执行 ,这 个 方法 会 通 
知 native 释放 WebView 占用 的 所 有 资源 。 

7. WebView 事件 回调 监听 

(1) public void setWebChromeClient (WebChromeClient client) 

作用 : 主要 通知 客户 端 App 加 载 当 前 网 页 的 对 话 框 网 站 图 标 、 网 站 标题 ,加 载 进 度 等 
事件 ,通知 客户 端 处 理 这 些 响 应 的 事件 。 例 如 : 


01 mWebView. setWebChromeClient(new WebChromeClient() { 
02 public void onProgressChanged(WebView view, int progress) { 


03 setProgress(progress * 100); 

04 if(progress == 100){ 

05 imageViewl.setVisibility(View. GONE); 
06 tvl.setVisibility(View.GONE); 

07 pbl.setVisibility(View.GONE); 

08 fyl.setVisibility(View.GONE); 

09 } 

10 } 


11 }); 


(2) public void setWebViewClient( WebViewClient client) 
作用 : 主要 通知 客户 端 App 加 载 当前 网 页 时 的 各 种 状态 ,如 onPageStart ,onPageFinish, 
onReceiveError 等 事件 。 例 如 : 


01 mWebView. setWebViewClient(new WebViewClient() { 


02 public void onReceivedError(WebView view, int errorCode, 

03 String description, String failingUrl) { 

04 //Handle the error 

05 Toast. makeText(gethpplicationContext()，" 网 络 连接 失败 ,请 连接 网 络 。"， 
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06 Toast.LENGTH SHORT).show(); 
07 } 


09 public boolean shouldOverrideUrlLoading(WebView view, String url) { 
10 view.loadUrl(url); return true; 

11 } 

12 3); 


6.2.3 页 面 导航 


当 用 户 在 WebView 中 点 击 一 个 链接 时 ,对 于 Android 来 说 默认 的 动作 是 启动 一 个 应 
用 程序 捕捉 它 。 通 常 ,默认 的 网 页 浏览 器 会 打开 并 且 载 入 目标 URL。 然 而 ,可 以 在 
WebView 中 重 写 该 动作 ,通过 调用 setWebViewClient() 方 法 把 该 链接 在 WebView 中 打 
开 。 还 可 以 让 用 户 自己 处 理 历史 的 回 退 和 前 进 功 能 。 

如 果 和 希望 点 击 页 面 中 的 链接 继续 在 当前 浏览 器 中 响应 ,而 不 是 启动 Android 系统 中 的 
浏览 器 响应 该 链接 ,必须 覆盖 WebView 的 WebViewClient 对 象 。 例 如 : 


01 webView. setWebViewClient(new WebViewClient()( 
02 @Overr ide 
03 public boolean shouldOverrideUrlLoading(WebView view, String url) { 


04 view.loadUrl(url); 
05 return true; 

06 } 

07 dy; 


如 果 要 在 点 击 链接 并 载 人 网 页 的 时 候 做 更 多 的 操作 ,可 以 创建 自己 的 WebViewClient 
并 重 写 shouldOverrideUrlLoading() 方 法 。 例 如 : 


01 private class MyWebViewClient extends WebViewClient { 

02 @Override 

03 public boolean shouldOverrideUrlLoading(WebView view, String url) { 
04 // 处 理 自己 的 页 面 


05 if (Uri.parse(url).getHost().equals("www.google.com")) { 

06 return false; 

07 H 

08 // 处 理 其 他 网 页 , 则 启动 另外 的 Activity KAk BET URL 

09 Intent intent = new Intent(Intent. ACTION VIEW, Uri.parse(url)); 
10 startActivity(intent) ; 

11 return true; 

12 } 

1395] 


然后 给 WebView 创建 一 个 WebViewClient 的 实例 。 
01 webView.setWebViewClient(new MyWebViewClient()); 
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这 时 , 当 用 户 点 击 一 个 链接 ,系统 就 会 调用 shouldOverrideUrlLoading (), 它 会 辨别 
URL 主机 是 否 要 匹配 指定 的 域名 。 如 果 它 不 能 匹配 , 则 该 方法 返回 false, 一 个 Intent 会 创 
建 并 启动 默认 的 Activity 来 处 理 该 URL( 它 一 般 解析 为 用 户 的 默认 浏览 器 ) 。 

用 WebView 点 击 链 接 访问 多 个 网 页 后 ,默认 情况 下 ,点 击 系统 返回 键 ,整个 浏览 器 会 
调用 finish() 而 结束 自身 , WebView 不 会 回 退 到 上 一 个 页 面 。 为 了 让 WebView 支持 回 退 
功能 ,需要 覆盖 Activity 类 的 onKeyDown() 方 法 ,可 以 使 用 goBack() 方 法 和 goForward() 
方法 操纵 回 退 和 向 前 功能 。 例 如 : 


01 @Override 
02 public boolean onKeyDown( int keyCode, KeyEvent event) { 
03 if ((keyCode == KeyEvent. KEYCODE BACK) && myWebView. canGoBack() { 


04 webView. goBack() ; 

05 return true; 

06 } 

07 return super. onKeyDown(keyCode, event) ; 
08 ] 


如 果 有 网 页 历史 , 则 canGoBack() 方 法 返回 True。 同 样 , 可 以 使 用 canGoForward O3E 
检查 是 否 有 “前 进 ” 历 史 。 如 果 不 执 行 这 个 检查 , 当 用 户 到 达 浏 览 历史 尽头 的 时 候 , goBack() 
和 goForward() 什 么 都 不 做 。 


6.2.4 WebSettings 与 缓存 处 理 


android. webkit. WebSettings 是 WebView 组 件 的 一 个 辅助 类 ,用 于 管理 WebView 的 
设置 状态 。 该 对 象 可 以 通过 WebView. getSettings() 方 法 获得 。 

WebSettings 提供 的 核心 方法 包括 以 下 几 种 。 

e setAllowFileAccess(boolean allow): 启用 或 禁止 WebView 访问 文件 数据 。 

。 setBlockNetworkImage(boolean allow): 确定 是 否 显 示 网 络 图 像 。 

* setLoadsImagesAutomatically(boolean flag): 设置 是 否 支持 自动 加 载 图 像 。 
setBuiltInZoomControls(boolean enabled) : 设置 是 否 支 持 缩放 。 
* setCacheMode(int mode) : 设置 缓冲 的 模式 。 
。 setDefaultFontSize(int size): 设置 默认 字体 的 大 小 。 
。 setDefaultTextEncodingName(String encoding) ; 设置 在 解码 时 使 用 的 默认 编码 。 
* setFixedFontFamily(String font): 设置 固定 使 用 的 字体 。 
* setJavaSciptEnabled(boolean flag) ; 设置 是 否 支持 Javascript。 
。 setJavaScriptCanOpenWindowsAutomatically(boolean flag): 设置 是 否 支持 通过 JS 
打开 新 窗口 。 
setLayoutAlgorithm( WebSettings. LayoutAlgorithm D : 设置 布局 方式 。 
setLightTouchEnabled(boolean enabled) : 设置 用 鼠标 激活 被 选项 。 
* setSupportZoom(boolean support); 设置 是 否 支持 变焦 。 
。 setPluginsEnabled(boolean flag): 设置 是 否 支 持 插件 。 
supportMultipleWindowsO : 多 窗口 支持 。 
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例如 ,打开 页 面 时 , 自 适 应 屏幕 的 代码 如 下 : 


01 WebSettings webSettings = mWebView.getSettings(); 
02 webSettings.setUseWideViewPort(true); “ // 设 置 此 属性 ,可 任意 比例 缩放 
03 webSettings. setLoadWithOverviewMode(true); 


下 面 的 代码 使 得 页 面 支持 缩放 : 


01 WebSettings webSettings = mWebView.getSettings(); 
02 webSettings. setJavaScriptEnabled(true); 

03 webSettings. setBuiltInZoomControls(true); 

04 webSettings. setSupportZoom(true) ; 


下 面 介 绍 一 下 关于 浏览 网 页 时 缓存 的 处 理 。 
Q@ 打开 及 关闭 缓存 。 
优先 使 用 缓存 的 代码 如 下 : 


01 webView.getSettings().setCacheMode(WebSettings.LOAD CACHE ELSE NETWORK); 


不 使 用 缓存 的 代码 如 下 : 


01 webView.getSettings().setCacheMode(WebSettings.LOAD NO CACHE); 


WebSettings. CacheMode 总 共有 以 下 4 个 选项 。 

。LOAD_DEFAULT: 这 是 默认 加 载 方式 ,使 用 这 种 方式 会 实现 快速 前 进 或 后 退 。 在 
同一 个 标签 中 打开 使 用 几 个 网 页 后 ,关闭 网 络 时 ,可 以 通过 前 进 \ 后 退 来 切换 已 经 访 
问 过 的 数据 。 同 时 新 建 网 页 时 需要 使 用 网 络 。 

。 LOAD_NO_CACHE 和 LOAD_NORMAL: 这 两 种 方式 不 使 用 缓存 。 如 果 没 有 网 
络 , 即 使 以 前 打开 过 此 网 页 ,也 不 会 使 用 以 前 的 网 页 。 

。 LOAD_CACHE_ELSE_NETWORK: 这 个 方式 总 是 会 从 缓存 中 加 载 ,除非 缓存 中 
的 网 页 过 期 ,出 现 的 问题 就 是 打开 动态 网 页 时 不 能 时 时 更 新 ,并 且 会 出 现 上 次 打开 
过 的 状态 ,除非 清除 了 缓存 。 

* LOAD CACHE ONLY; 这 个 方式 只 会 使 用 缓存 中 的 数据 ,不 会 使 用 网 络 。 

影响 缓存 模式 的 两 个 http 头 是 If-None-Match 和 If-Modified-Since, 遇 到 这 两 个 http 

头 , 浏 览 器 会 把 缓存 模式 改 为 LOAD_NO_CACHE。 
@ 在 退出 应 用 程序 时 删除 缓存 的 代码 如 下 : 


01 File file = CacheManager. getCacheFileBaseDir(); 

02 if (file != null && file.exists() && file. isDirectory()) { 
03 for (File item : file.listFiles()) ( 

04 item.delete(); 

05 } 

06 file. delete(); 
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07 ] 
08 context.deleteDatabase("webview. db"); 
09  context.deleteDatabase("webviewCache. db"); 


@ 删除 保存 在 手机 上 的 缓存 代码 如 下 : 


01 private int clearCacheFolder(File dir, long numDays) { 
02 int deletedFiles = 0; 
03 if (dir!= null && dir. isDirectory()) { 


04 try { 

05 for (File child: dir. listFiles()) { 

06 if (child. isDirectory()) { 

07 deletedFiles += clearCacheFolder(child, numDays) ; 
08 } 

09 

10 if (child. lastModified() < numDays) { 
11 if (child. delete()) { 

12 deletedFiles++; 

13 } 

14 } 

15 } 

16 } catch(Exception e) { 

un e. printStackTrace( ) ; 

18 } 

19 } 

20 return deletedF iles; 

e 


6.2.5 WebChromeClient fil WebViewClient 


Ej WebView 相关 的 辅助 对 象 ,除了 WebSettings 以 外 ,还 有 WebChromeClient 和 
WebViewClient. 

1. WebChromeClient 

WebChromeClient 主要 用 来 辅助 WebView 处 理 Javascript 的 对 话 框 ,网 站 图 标 、 网 站 
标题 以 及 网 页 加 载 进度 等 。 

同样 地 ,可 以 通过 WebView 的 setWebChromeClient() 方 法 为 WebView 对 象 指定 一 个 
WebChromeClient. 

在 WebChromeClient 中 , 当 网 页 的 加 载 进度 发 生变 化 时 ,onProgressChanged (WebView 
view, int newProgress) 方 法 会 被 调用 ; 当 网 页 的 图 标 发 生 改 变 时 , onReceivedIcon 
(WebView view. Bitmap icon) 方 法 会 被 调用 ; 当 网 页 的 标题 发 生 改 变 时 ,onReceivedTitle 
(WebView view, String title) 方 法 会 被 调用 。 利 用 这 些 方法 , 便 可 以 很 容易 地 获得 网 页 的 
加 载 进度 、 网 页 的 图 标 和 标题 等 信息 ,例如 : 


01 MyWebChromeClient myWebChromeClient = new MyWebChromeClient(); 
02 mWebView. setWebChromeClient(myWebChromeClient); 
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private class MyWebChromeClient extends WebChromeClient { 


// 获 得 网 页 的 加 载 进度 ,显示 在 右上 角 的 TextView 控件 中 
public void onProgressChanged(WebView view, int newProgress) { 
if(newProgress « 100) ( 
String progress = newProgress + "%"; 
mTextView_progress. setText (progress) ; 
} else { 
mTextView progress.setText(" "); 
} 
l 


// 获 得 网 页 的 标题 , 作为 应 用 程序 的 标题 进行 显示 

public void onReceivedTitle(WebView view, String title) { 
MainActivity. this. setTitle(title); 

} 


WebViewClient 


WebViewClient 类 定义 了 一 系列 事件 方法 ,如 果 Android 应 用 程序 设置 了 
WebVieClient 派生 对 象 , 则 在 网 页 载 信 、 资 源 载 入 、 页 面 访问 错误 等 情况 发 生 时 ,该 派生 对 
象 的 相应 方法 会 被 调用 。 

WebViewClient 常用 方法 包括 以 下 几 种 。 


doUpdateVisitedHistory( WebView view, String url, boolean isReload): 更 新 历史 

记录 。 

onFormResubmission( WebView view, Message dontResend, Message resend); 应 

用 程序 重新 请 求 网 页 数据 。 

onLoadResource( WebView view, String url); 该 方法 在 加 载 页 面 资源 时 会 被 调用 ， 

每 一 个 资源 (比如 图 像 ) 的 加 载 都 会 调用 一 次 。 

onPageStarted(WebView view, String url, Bitmap favicon): 这 个 事件 就 是 开始 载 

和 人 页面 时 调用 的 ,通常 可 以 在 这 里 设 定 一 个 loading 页 面 ,告诉 用 户 程序 在 等 待 网 络 

响应 。 

onPageFinished(WebView view, String url): 在 页 面 加 载 结束 时 调用 该 方法 。 一 

个 页 面 载 人 完成 后 ,可 以 关闭 loading 条 并 切换 程序 的 动作 。 

onReceivedError(WebView view. int errorCode，String description, String failingUrD ; 

报告 错误 信息 。 

onReceivedHttpAuthRequest (WebView view, HttpAuthHandler handler. String 

host.String realm): 获取 返回 信息 授权 请 求 。 

onReceivedSslError ( WebView view，SslErrorHandler handler, SslError error): 

重 写 此 方法 可 以 让 WebView Ab 38 https 请 求 。 

onScaleChanged(WebView view, float oldScale, float newScale): WebView AE 
169 





移动 互联 网 应 用 开发 (基于 Android = 8) 


170 


改变 时 调用 该 方法 。 

onUnhandledKeyEvent(WebView view, KeyEvent event): Key 事件 未 被 加 载 时 调 
用 该 方法 。 

shouldOverrideKeyEvent( WebView view, KeyEvent event): 重 写 此 方法 才能 够 处 
理 在 浏览 器 中 的 按键 事件 。 

shouldOverrideUrlLoading( WebView view, String url): 在 点 击 请 求 链接 时 才 会 调 
用 , 重 写 此 方法 则 返回 true, 表明 无 论 是 点 击 网 页 里 面 的 链接 还 是 在 当前 的 
WebView 里 跳 转 ,都 会 跳 到 浏览 器 中 。 


代码 举例 如 下 : 

01 WebViewClient wvc = new WebViewClient() { 

02 

03 @Override 

04 public boolean shouldOverrideUrlLoading(WebView view, String url) { 
05 Toast. makeText (getApplicationContext(), 

06 "WebViewClient. shouldOverrideUrlLoading", 
07 Toast.LENGTH SHORT) 

08 . show() ; 

09 // 使 用 自己 的 WebView 组 件 来 响应 Url 加 载 事件 ,而 不 是 使 用 默认 浏览 器 加 载 页 面 
10 wv. loadUrl(url); 

TI return true; 

12 } 

13 

14 @Overr ide 

15 public void onPageStarted(WebView view, String url, Bitmap favicon) { 
16 Toast. makeText (getApplicationContext(), 

i7 "WebViewClient. onPageStarted", 

18 Toast. LENGTH_SHORT) . show( ) ; 

19 super. onPageStarted(view, url, favicon); 

20 } 

21 

22 @Override 

23 public void onPageF inished(WebView view, String url) { 
24 Toast. makeText (getApplicationContext(), 

25 "WebViewClient. onPageFinished", 

26 Toast.LENGTH SHORT).show(); 

27 super. onPageF inished( view, url); 

28 } 

29 

30 @Override 

31 public void onLoadResource(WebView view, String url) { 
32 Toast. makeText (getApplicationContext(), 

33 "WebViewClient. onLoadResource" , 

34 Toast.LENGTH SHORT).show(); 

35 super. onLoadResource(view, url); 

36 } 

37 

38) y; 
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6.3 使 用 HTML5 开发 Web App 


HTML5 针对 移动 Web 应 用 程序 引入 了 大 量 新 特性 ,其 中 包括 离线 缓存 技术 .音频 视 
频 自由 典 入 \ 地 理 位 置 获取 、Canvas 绘图 .丰富 的 表单 元 素 及 交互 方式 等 ,另外 ,结合 Jquery 
Mobile 等 框架 提供 的 可 视 化 特性 ,使 得 应 用 程序 给 用 户 带 来 强烈 的 视觉 冲击 。 


6.3.1 使 用 JavaScript 访问 Android 


使 用 WebView 进行 移动 应 用 开发 的 目的 ,不 仅仅 是 作为 查看 网 站 的 手段 。 相 反 , 应 用 
程序 嵌入 的 网 页 应 该 针对 环境 而 进行 设计 ,甚至 可 以 定义 Android 应 用 程序 和 网 页 之 间 的 
接口 ,这 一 接口 允许 JavaScript 调用 Android 应 用 程序 API 向 基于 Web 的 应 用 程序 提 
供 支持 。 

如 果 载 人 的 网 页 实现 了 JavaScript, VE WebView 中 开启 JavaScript 功能 ,并 在 应 用 
代码 和 JavaScript 代码 之 间 创 建 接口 。 步 又 如 下 : 

1. 开启 JavaScript 

在 WebView 中 JavaScript 默认 是 不 开启 的 。 可 以 通过 WebSettings( 使 用 getSettings() 方 
法 获得 WebSettings) 设 置 WebView 对 JavaScript 的 开启 ,然后 使 用 setJavaScriptEnabled() 来 开 
启 它 。 例 如 : 





01 WebView mWebView = (WebView) findViewById(R. id.webview); 
02 WebSettings webSettings = mWebView. getSettings(); 
03 webSettings. setJavaScriptEnabled(true); 


在 WebSettings 中 已 经 实现 了 很 多 有 用 的 功能 。 例 如 ,如 果 使 用 WebView 开发 一 个 网 
络 应 用 ,可 以 使 用 setUserAgentString() 方 法 定义 一 个 自 定义 用 户 代 理 字符 串 ,后面 可 以 查 
询 网 页 中 的 自 定义 用 户 代 理 , 以 便 辨别 当前 请 求 网 页 的 是 不 是 Android 应 用 。 

2. $ JavaScript 到 Android 中 

当 使 用 WebView 创建 网 络 应 用 的 时 候 , 可 以 在 JavaScript 和 Android 源 代码 之 间 创 建 
一 个 接口 ,例如 , 当 点 击 页 面 中 的 电话 号 码 时 ,让 JavaScript 代码 调用 Android 中 定义 的 方 
法 来 实现 拨号 功能 。 例 如 : 


01 public class JavaScriptInterface { 

02 Context mContext; 

03 

04 JavaScriptInterface(Context c) { 

05 mContext - c; 

06 | 

07 

08 public void startPhone(String num) { 

09 Intent intent = new Intent(); 

10 intent. setAction(Intent. ACTION CALL); 
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iby intent. setData(Uri. parse("tel:" + num) ); 
12 startActivity(intent) ; 

13 } 

14 

Gy 


在 WebView 中 使 用 addJavascriptInterface(Object obj ,String interfaceName) 7j i; f 
一 个 Java 对 象 绑 定 到 一 个 Javascript MAP Javascript 对 象 名 就 是 interfaceName, 作 用 域 
是 全 局 的 。 例 如 : 


01 webView.addJavascriptInterface(new JavaScriptInterface(this), "Android"); 


这 段 代 码 创 建 了 一 个 名 称 为 “Android” 的 JavaScript 接口 并 运行 在 WebView 当中 。 
Web 应 用 会 接 人 JavaScriptInterface 类 。 例 如 ,下 面 的 代码 会 在 用 户 点 击 电话 号 码 链 接 时 
启动 Android 自 带 的 拨号 程序 。 


01 <!DOCTYPE html PUBLIC " - //W3C//DTD HTML 4.01 Transitional//EN" 


02 "http://www. w3. org/TR/ htn14/10oose. dtd"> 

03 <html> 

04 <head> 

05 <meta http — equiv = "Content - Type" content = "text/html; charset = UTF - 8"> 
06 «title» Javascript Demo </title> 

07 </head> 

08 <body > 

09 <table align="center"> 

10 <tr><td> 部 门 </td><td> 电 话 </td></tr> 

11 <tr><td> 移 动 </td><td> 

12 <a href= "javascript:Android. startPhone(10086)"> 10086 </a> 
13 </td></tr> 

14 </table> 

15 X/body » 

16 «/html» 


不 需要 初始 化 JavaScript 中 的 Android 接口 。WebView 会 自动 让 它 可 以 应 用 于 网 页 
当中 。 

注意 : 在 JavaScript 中 绑 定 的 对 象 会 运行 在 另 一 个 线程 , 它 和 创建 它 的 线程 是 不 同 的 
线程 。 使 用 addJavaScriptInterface() 允 许 JavaScript 来 控制 Android 应 用 。 


6.3.2 使 用 CSS 适 配 UI 


当 Android 浏览 器 加 载 一 个 网 页 时 ,默认 是 以 “概览 模式 ”加 载 这 个 页 面 ,“ 概 览 模式 ”是 
指 提供 缩小 至 这 个 页 面 的 远景 的 视图 。Android 浏览 器 和 WebView 会 通过 缩放 网 页 补偿 
屏幕 密度 的 变化 ,使 得 所 有 的 设备 在 显示 此 网 页 时 看 上 去 和 中 等 密度 下 显示 的 大 小 相同 。 

Android 浏览 器 和 WebView 支持 CSS 媒介 类 型 ,可 以 使 用 -webkit-device-pixel-ratio 
的 CSS 媒介 类 型 为 特定 的 屏幕 密度 创建 一 个 样式 。 人 允许 使 用 的 值 包括 0.75、1 或 1.5, 分 别 
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表示 低 、 中 和 高 密度 屏幕 。 
例如 ,可 以 分 别 为 每 个 密度 建立 样式 表 。 


01 <link rel= "stylesheet" 

02 media= "screen and ( — webkit - device- pixel- ratio: 1.5)" 
03 href = "hdpi.css" /> 

04 <link rel="stylesheet” 

05 media = "screen and ( — webkit - device- pixel — ratio: 1.0)" 
06 href = "mdpi.css" /> 

07 <link rel="stylesheet" 

08 media = "screen and ( — webkit — device- pixel- ratio: 0.75)" 
09 href = "ldpi.css" /> 


或 者 在 一 个 样式 表 中 指定 不 同 的 样式 ,例如 : 


01 #header { 
02 background:url(medium- density — image. png); 
O32] 


05 @media screen and ( - webkit - device- pixel- ratio: 1.5) { 
06 / * CSS for high-density screens « / 

07 $t header ( 

08 background:url(high - density - image. png); 

09 } 

TED 


12 @media screen and ( - webkit - device - pixel- ratio: 0.75) { 
13 / * CSS for low-density screens * / 

14 # header { 

15 background:url(low- density- image. png) ; 

16 } 

iii dr 


为 了 提供 完全 自 定 义 的 样式 ,使 页 面 是 为 每 个 支持 的 密度 定制 的 ,应 该 设置 viewport 
属性 , 使 viewport 的 宽度 和 密度 和 设备 相 匹配 。 通 过 这 种 方式 ,Android 浏览 器 和 
WebView 不 对 网 页 进行 缩放 ,并 且 viewport 宽度 完全 匹配 于 屏幕 宽度 。 但 是 通过 添加 一 
些 使 用 -webkit-device-pixel-ratio 媒介 类 型 的 自 定义 CSS ,可 以 使 用 不 同 的 样式 。 


6.3.3 jQuery Mobile 框架 


jQuery Mobile 是 一 个 针对 触摸 体验 的 Web UI 开发 框架 ,实现 开发 跨 智能 电话 和 平板 
电脑 工作 的 移动 Web 应 用 程序 。jQueryMobile 框架 构建 于 jQuery 内 核 之 上 ,提供 了 构建 
完整 移动 Web 应 用 程序 和 网 站 所 需 的 所 有 UI 组件 ,包括 页 面 、 对 话 框 、 工 具 栏 ,不 同类 型 的 
列表 视图 ,各 种 表单 元 素 和 按钮 等 。 

jQuery Mobile 基本 特性 包括 以 下 几 种 。 

1. 一 般 简单 性 和 灵活 性 

该 框架 易于 使 用 ,可 以 使 用 标记 驱动 开发 页 面 ,无 须 或 仅 需 很 少 的 JavaScript; 使 用 高 
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级 JavaScript 和 事件 ; 使 用 一 个 HTML 文件 和 多 个 嵌入 页 面 ; 将 应 用 程序 分 解 成 多 个 
页 面 。 

2. 逐步 强化 和 全 面 兼容 

尽管 jQuery Mobile 利用 最 新 的 HTML5、CSS3 和 JavaScript, 但 并 非 所 有 移动 设备 都 
提供 这 样 的 支持 。jQuery Mobile 的 理念 是 同时 支持 高 端 和 低 端 设备 , 比如 那些 不 支持 
JavaScript 的 设备 ,尽量 提供 最 好 的 体验 。 

3. 支持 触摸 屏 输入 和 其 他 输入 方法 

jQuery Mobile 为 不 同 输入 方法 和 事件 提供 支持 : 触摸 屏 、 鼠 标 和 基于 光标 焦点 的 用 户 
输入 。 

4. 可 访问 性 

jQuery Mobile 在 设计 时 考虑 了 访问 能 力 , 它 支持 Accessible Rich Internet Applications 
(WAI-ARIA), 以 帮助 使 用 辅助 技术 的 残障 人 士 访问 Web 页 面 。 

5. 轻 量 级 和 模块 化 

该 框架 属于 轻 量 级 ,拥有 一 个 大 小 为 24KB 的 JavaScript FE, 7KB 的 CSS 以 及 一 些 
图 标 。 

6. 主题 

该 框架 还 提供 一 个 主题 系统 ,允许 定义 自己 的 应 用 程序 样式 。 

下 面 以 一 个 图 像 浏 览 应 用 来 介绍 基于 HTML5 十 jQuery Mobile 开发 Web App 的 
方法 。 

Activity 实例 类 核心 代码 如 下 : 

01 public class HTML5Activity extends Activity { 


02 
03 private WebView webView; 


05 @Override 
06 protected void onCreate(Bundle savedInstanceState) { 


07 super. onCreate(savedInstanceState) ; 

08 

09 setContentView(R. layout. activity_htm15) ; 

10 webView = (WebView) findViewById(R. id. fullscreen_content) ; 
iul webView.setWebViewClient(new MyWebViewClient()); 

12 webView. loadUrl("file:///android asset/www/index. html"); 
13 webView. setWebChromeClient(new WebChromeClient()); 

14 WebSettings webSettings = webView.getSettings(); 

15 webSettings. setJavaScriptEnabled( true); 

16 webSettings. setDomStorageEnabled( true); 

17 webSettings.setDatabasePath("/data/data/" * this.getPackageNane() 
18 * "/databases/"); 

19 

20 } 

21 


22 @Override 
23 public void onBackPressed() { 
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24 if (webView. canGoBack( )) 

25 webView. goBack( ) ; 

26 else 

27 super. onBackPressed( ) ; 

28 } 

29 

30 @Override 

at protected void onPostCreate(Bundle savedInstanceState) { 
32 super. onPostCreate(savedInstanceState); 
33 } 

34 } 


其 中 ,第 11 行 的 MyWebViewClient() 代 码 如 下 : 


01 public class MyWebViewClient extends WebViewClient { 
02 @Override 
03 public boolean shouldOverrideUrlLoading(WebView view, String url) { 


04 view.loadUrl(url); 
05 return true; 

06 } 

e i 


在 Intel XDK? 中 ,选择 Start with App Designer 来 创建 HTML S5 项 目 ,项 目 框架 选择 
jQuery Mobile ,如 图 6-3 所 示 o 


Select a Framework 


Selecta © App Framework 


Framework © Twitter Bootstrap 3 


® jQuery Mobile 


5 Topcoat 
jQueryMobile is designed for mobile devices. Depends upon 
jQuery. 
Group 
Checkbox 
Checkbox 
Checkbox 


Group 


Radio Button 





图 6-3 Web App 设计 效果 


@ 开发 环境 下 载 地 址 为 https://software. intel. com/en-us/html5/tools, 
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实现 index. html 主页 面 的 核心 代码 如 下 : 


01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
7 
12 
13 
14 
15 
16 
17 
18 
19 
20 
ZI 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 


<! DOCTYPE html > 


<html> 
<head> 
<meta name = "Copyright" content = "&copy; 2012, Intel Corporation. 
All rights reserved." /> 
< script type = "text/javascript" 
src = "vendor/jquery/jquery— 1.8.0. js"></script > 
< script type = "text/javascript" src = "app/config. js"></script > 
< script type = "text/javascript" 
src = "vendor/jquery. mobile/jquery. mobile - 1.1.1. js"></script > 
<script type = "text/javascript" src= "app/tabbedimages. js"></script > 
< script type = "text/javascript" src= "app/optionsWidget. js"></script > 
< script src = "corodova. js"></script > 
< script src = " intelxdk. js"></script > 
<script src = "xhr. js"></script > 
< script type = "text/javascript"> 
var onDeviceReady = function()( 
if( window.Cordova && navigator. splashscreen ) ( 
navigator. splashscreen.hide() ; 
} 
un 
document. addEventListener("deviceready", onDeviceReady, false) ; 
</script > 
<meta name = "viewport" content = "width = device- width, initial- scale=1, 
maximum — scale = 1, user — scalable = 0"> 
</head > 
<body > 
X! ——- home page 一 一 > 
<div data - role = "page" id= "birds" 
<= header ==> 
<div data- role = "header" data- id= "tabnav - header" 
data- position = "fixed" data- theme = "b"> 
€ hl > Albums </hl > 
</div> 
</div> 
el ——» 
<div data - role = "page" id- "flowers" 
</div> 
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49 <! -— page 3 -一 > 

50 <div data - role = "page" id= "animals"> 
DE eu 

52 </div> 

53 

54 

55 < script type = "text/javascript"> 

56 $ ("# birds"). die("pageinit"); 
57 $ ("# flowers").die("pageinit"); 
58 $ (" & animals") .die("pageinit"); 
59 </script > 

60 

61 </body> 

62 

63 </html> 

CSS 样式 核心 代码 如 下 : 

01 body { 


02 /* background: #232323 ! important; * / 
03 background: #b4e391; /* Old browsers * / 
04 background: - moz- linear- gradient(top, #b4e391 0%, #61c41950%, 


05 $b4e391 100 $ ); 

06 background: - webkit - gradient(linear, left top, left bottom, 
07 color - stop(0 * , i£ b4e391), color- stop(50 % , #61c419), 
08 color - stop(100 % , + b4e391)); 

090 

10 } 

DI 


12 /* ensure background takes up entire screen * / 
13 html, body { 


14 width: 100% ; 

15 height: 100% ; 

16 overflow: hidden; 

17 margin: Opx ! important; 
18 padding: Opx ! important; 
sE 

20 

21 .content div( 

22 position: fixed; 

23 width: 100% ; 

24 padding: Opx ! important; 
25 margin: 0px ! important; 
26 

W F 

28 

29 .mainimage div{ 

30 position: fixed; 

31 padding: Opx ! important; 
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32 margin: Opx !important; 
33 width: 100% ; 

34 top: 36px; 

35 

36 /* height: 80%; 

37 width: 95% ; */ 

38 ] 

39 

40 .thumbnails_div{ 

41 position: fixed; 

42 padding: Opx ! important; 
43 margin: Opx !important; 
44 width: 100%; 

45 /* padding-bottom: 36px; * / 
46 

47 

48 } 

49 

50 .mainimage{ 

51 max- width: 100% ; 

52 max- height: 100 % ; 


53 /*  top-margin: -30px; * / 
54 padding: Opx ! important; 

55 margin - top: Opx ! important; 

56 margin - bottom: Opx ! important; 
DIE margin - left: auto; 

58 margin right: auto; 

59 

60 

61 display: block; 

62 } 

63 

64 .thumbnail:hover{ opacity: 0.7; } 
65 .thumbnail:active { opacity: 0.7;} 


66 

67 . thumbnail { 

68 max — height: 100 % ; 
69 max- width: 15%; 
70 /* min-width: 46px; * / 
71 width: 12$; 

72 

ex ds 

74 .highlight( 

75 opacity: 0.5; 

7} 

77 


78 /x override default jQuery Mobile page styling x / 
79 .ui- page { 
80 /* transparent page (to go over linen background) with white font * / 


178 


BOR Web 应 用 编程 





81 background: none; 

82 background — image: none; 

83 color: white; 

84 

85 /* hacks to get smoother page transition, esp on older Androids * / 
86 — webkit- backface - visibility: hidden; 
87 — moz - backface - visibility: hidden; 

88 一 ms - backface - visibility: hidden; 

89 —0- backface- visibility: hidden; 

90 backface - visibility: hidden; 

91 } 

92 


93 /* custom styling of options menu (position & width) * / 
94 .optionsMenu ( 


95 width: 120px; 

96 position: fixed; 

97 right: lpx; 

98 } 

99 

100 .optionsMenu .ui- field- contain { 
101 margin: 0; 

102 padding: 0; 

103 } 

104 

105 .optionsMenu .ui- controlgroup - controls { 
106 width: 100% ; 

107 } 

108 


109 /* no rounded corners for options menu * / 
110 .optionsMenu .ui- corner- top, .ui- corner- bottom { 


111 — webkit- border - radius: Opx ! important; 
112 — moz - border - radius: Opx ! important; 
113 一 ms - border - radius: Opx ! important; 

114 — o- border - radius: Opx ! important; 

115 border- radius: Opx ! important; 

116 } 


config. js 核心 代码 如 下 : 


01 $ (document).bind('mobileinit', function () { 

02 $ .mobile. defaultPageTransition = 'none'; 

03 Py 

04 

05 /* keep header and footer visible at all times * / 

06 $ (document).on('pageinit', ':jamData(role- page)', function() ( 


07 $ (this).find(':jamData(role = header) '). fixedtoolbar( { 
08 tapToggle: false } ); 

09 $ (this).find(':jqmData(role = footer) ').fixedtoolbar( { 
10 tapToggle: false } ); 

DI 
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将 XDK 中 的 项 目 复制 到 Android 项 目的 assets 文件 夹 下 ,并 运行 项 目 。 设 计 效 果 如 
图 6-4 所 示 。 





图 6-4 Web App 设计 效果 


6.4 =] 题 


1. 编程 实现 基于 WebView 的 地 图 设计 。 
2. 编程 实现 基于 HTML5 技术 在 WebView 中 播放 视频 。 
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作为 Internet 异 构 环境 下 的 互 操作 技术 ,Web 服务 被 广泛 应 用 ,并 衍生 出 基于 开放 接 
口 的 网 络 编程 技术 。 


7.1 Web 服务 编程 


Web 服务 (WebService 或 Web Service) 是 可 供 外 部 使 用 的 分 布 式 应 用 程序 组 件 , 通 过 
Web 服务 实现 不 同系 统 之 间 的 相互 调用 ,从 而 实现 系统 集成 的 平台 无 关 性 .语言 无 关 性 。 


7.1.1 Web 服务 概述 


Web 服务 是 一 种 服务 导向 架构 的 技术 ,通过 标准 的 Web 协议 提供 服务 ,目的 是 保证 不 
同 平台 的 应 用 服务 可 以 互 操作 。 

1. Web 服务 协议 

根据 W3C 的 定义 , Web 服务 应 当 是 一 个 软件 系统 ,用 以 支持 网 络 间 不 同 机 器 的 互动 操 
f£. Web 服务 通常 是 由 许多 应 用 程序 接口 (API) 所 组 成 的 ,它们 通过 网 络 执行 客户 所 提交 
服务 的 请 求 ,使 调用 者 能 够 用 编程 的 方式 通过 Web 调用 来 开发 应 用 程序 。 

Web 服务 也 遵循 Web 通信 协议 ,如 HTTP、TCP/IP、SMTP 等 。 不同 的 系统 需要 遵守 
同一 种 协议 来 发 送 和 接收 XML 数据 (由 于 Web 服务 要 最 终 实现 跨 平台 、 跨 语言 之 间 的 互 
相通 信和 数据 共享 ,数据 的 传输 必须 以 一 定 的 格式 和 标准 进行 ,这 种 标准 就 是 XML) , 达到 
通信 的 目的 ,这 个 协议 是 SOAP(Simple Object Access Protocl ,简单 对 象 访问 协议 ) 。 

各 类 Web 服务 框架 的 本 质 就 是 一 个 大 的 Servlet. 当 远 程 客户 端 通过 HTTP 协议 发 送 
来 SOAP 格式 的 请 求 数据 时 , 它 分 析 这 个 数据 ,就 知道 要 调用 服务 端的 哪个 Java 类 以 及 哪 
个 方法 。 当 确定 了 服务 端 Java 类 以 及 方法 后 ,服务 就 去 查找 或 者 创建 这 个 对 象 ,并 调用 
其 方法 ,再 把 方法 返回 的 结果 包装 成 SOAP 格式 Registry 
的 数据 ,通过 HTTP 协议 将 消息 发 给 客户 端 。 

2. Web 服务 体系 结构 

Web 服务 的 体系 是 一 种 面向 服务 的 体系 结 
构 。 包 括 三 种 角色 ( 见 图 7-1)。 

(1) 服务 提供 商 

发 布 自己 的 服务 ,并 且 对 服务 请 求 进行 响应 。 s 

开发 完 Web 服务 后 ,需要 一 种 发 布 手段 让 自 Provider Requester 
己 的 Web 服务 被 网 络 上 任何 一 个 地 点 的 人 或 者 系 图 7-1 Web 服务 体系 结构 





3. found services 
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统 得 知 从 而 调用 它 ,这 个 手段 是 UDDI( 通 用 描述 发现 与 集成 )。 服 务 提 供 者 要 在 UDDI 注 
册 中 心 注 册 。 

(2) 服务 代理 商 

注册 已 经 发 布 的 Web 服务 ,对 其 进行 分 类 ,并 提供 搜索 服务 。 

UDDI 注册 中 心 扮演 了 服务 “代理 者 ”的 角色 , 它 通 过 WSDLCOWeb Service Description 
Language, Web 服务 描述 语言 ) 来 向 服务 请 求 者 展示 已 经 注册 的 Web IRF. 

(3) 服务 请 求 者 

利用 服务 代理 商 查找 所 需 的 服务 ,然后 使 用 该 服务 。 

也 就 是 在 UDDI 中 心 ,通过 WSDL 查找 已 经 发 布 的 Web 服务 ,以 便 自己 使 用 。 

3. Web 服务 编程 模型 

为 Web 服务 开发 者 提供 了 多 个 编程 模型 。 这 些 模 型 分 为 两 类 。 

(1) 基于 REST 

表述 性 状态 传递 (Representational State Transfer, REST) 是 一 种 创建 并 与 Web 服务 
通信 的 新 方法 。 在 REST 中 ,资源 具有 URI 并 通过 HTTP 头 操作 进行 处 理 。 每 个 文档 和 
每 个 流程 都 通过 唯一 的 URI 建 模 为 Web 资源 。 这 些 Web 资源 由 可 以 在 HTTP 头 中 指定 
的 操作 处 理 。HTTP 是 REST 中 的 协议 。 仅 有 四 种 方法 可 用 : GET, PUT, POST 和 
DELETE。 可 以 对 请 求 标记 书签 并 可 以 缓存 响应 。 网 络 管理 员 只 需 通过 查看 HTTP 头 ,就 
可 以 方便 地 跟踪 REST 风格 的 服务 。 

(2) 基于 SOAP/WSDL 

在 基于 SOAP 的 Web 服务 中 ,Java 实用 程序 基于 Web 服务 中 的 Java 代码 创建 WSDL 
文件 。WSDL 可 以 在 网 络 上 公开 。 对 使 用 Web 服务 感 兴趣 的 各 方 可 以 基于 WSDL 创建 
Java 客户 端 。 消 息 以 SOAP 格式 进行 交换 。 可 以 传人 SOAP 的 操作 范围 比 REST 中 提供 
的 要 宽 得 多 ,特别 是 在 安全 性 方面 。 


7.1.2 核心 技术 


1. SOAP 
SOAP 指 简单 对 象 访问 协议 (Simple Object Access Protocol) , 它 是 一 种 基于 XML 的 
可 扩展 消息 信封 格式 ,用 于 网 络 上 不 同 平台 \ 不 同 语言 的 应 用 程序 间 的 通信 。 

SOAP 包括 三 个 部 分 。 

* SOAP 封装 : 它 定义 了 一 个 框架 ,该 框架 描述 了 消息 中 的 内 容 是 什么 , 谁 应 当 处 理 它 
以 及 它 是 可 选 的 还 是 必需 的 。 

* SOAP 编码 规则 : 它 定 义 了 一 种 序列 化 的 机 制 ,用 于 交换 应 用 程序 所 定义 的 数据 类 
型 的 实例 。 

* SOAP RPC 表示 : 它 定 义 了 用 于 表示 远程 过 程 调用 和 应 答 的 协定 。 

一 条 SOAP 消息 就 是 一 个 普通 的 XML 文档 ,基本 结构 如 下 : 


01 «? xnl version- "1.0"?> 
02 <soap:Envelope 
03 xnlns:soap = "http://www. w3. org/2001/12/soap — envelope" 
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04 
05 
06 
07 
08 
09 
10 
II 
12 
13 
14 


soap:encodingStyle = "http://www. w3. org/2001/12/soap - encoding"> 
< soap:Header > 


</soap:Header > 
< soap:Body > 


< soap: Fault» 
</soap: Fault > 


</soap : Body > 
</soap:Envelope > 


SOAP 消息 必须 用 XML 来 编码 , 且 必 须 使 用 Envelope 命名 空间 和 Encoding 命名 空 
la], SOAP 消息 不 能 包含 DTD 引用 ,也 不 能 包含 XML 处 理 指令 。 
SOP 中 各 元 素 的 含义 如 下 。 


Envelope 元 素 : 标识 XML 文档 的 一 条 SOAP 消息 。 
Header 元 素 : 包含 头 部 信息 的 XML 标签 。 

Body 元 素 : 包含 所 有 的 调用 和 响应 的 主体 信息 的 标签 。 
Fault 元 素 : 错误 信息 标签 。 


下 面 的 例子 中 ,一 个 GetStockPrice 请 求 被 发 送 到 了 服务 器 。 此 请 求 有 一 个 StockName & 
数 ,而 在 响应 中 则 会 返回 一 个 Price 参数 。 


SOAP 请 求 。 


POST /InStock HTTP/1.1 


01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 


01 
02 
03 
04 


Host: www. jsoso. net 
Content - Type: application/soap + xml; charset = utf - 8 
Content — Length: X X x 


<? xnl version = "1. 0"?> 
< soap: Envelope 
xmlns:soap = "http://www. w3. org/2001/12/soap— envelope" 
Soap: encodingStyle = "http://www. w3. org/2001/12/soap - encoding"> 
< soap: Body xmlns:m= "http://www. jsoso. net/stock"> 
<m:GetStockPrice > 
< n: StockNane > IBM </m:StockName > 
</m:GetStockPrice > 
</soap : Body > 
«/soap:Envelope > 


SOAP 响应 。 
HTTP/1.1 200 OK 


Content - Type: application/soap + xml; charset = utf - 8 
Content - Length: X X X 
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05 
06 
07 


14 


2. 


<? xml version- "1.0"?> 
< soap:Envelope 
xmlns:soap = "http://www. w3. org/2001/12/soap— envelope" 
Soap: encodingStyle = "http://www. w3. org/2001/12/soap - encoding"> 
< soap: Body xmlns:m= "http://www. jsoso. net/stock"> 
<m:GetStockPriceResponse > 
<m:Price > 34.5 </m:Price> 
</m: GetStockPriceResponse > 
«/soap:Body > 
«/soap:Envelope > 


WSDL 


WSDL(Web Service Description Language. Web 服务 描述 语言 ) 是 一 种 XML 格式 文 
档 ,用 以 描述 服务 端口 访问 方式 和 使 用 协议 的 细节 。 通 常用 来 辅助 生成 服务 器 和 客户 端 代 
码 及 配置 信息 。WSDL 文档 包括 访问 和 使 用 Web 服务 所 必需 的 信息 ,定义 该 Web 服务 的 
位 置 .功能 以 及 如 何 通 信 等 描述 信息 。 

一 个 WSDL 文档 在 定义 网 络 服务 时 使 用 如 下 的 元 素 。 


definitions; WSDL 文档 的 根 元 素 ,该 元 素 的 属性 指明 了 WSDL 文档 的 名 称 ,文档 的 
目标 名 字 空 间 , 以 及 WSDL 文档 应 用 的 名 字 空 间 的 速记 定义 。 

types: 使 用 某 种 方式 (如 XSD) 的 数据 类 型 定义 集合 ,形成 服务 所 用 消息 的 构建 块 。 
message; 用 于 通信 的 抽象 数据 类 型 定义 , 即 参数 。 

operation; 一 个 服务 包含 的 操作 的 描述 , 当 操作 被 调用 时 ,操作 被 定义 为 两 个 低 端 
之 间 的 消息 传递 。 

portType: 描述 服务 逻辑 接口 的 operation 元 素 的 集合 。 

binding: 特定 端口 类 型 所 使 用 的 具体 协议 和 数据 格式 规范 。 一 个 binding 元 素 定义 
如 何 将 一 个 抽象 消息 映射 到 一 个 具体 数据 格式 。 该 元 素 指明 诸如 参数 顺序 .返回 值 
等 信息 。 

port; 绑 定 和 网 络 地 址 关联 的 单一 接 人 点 ,这 个 元 素 将 所 有 抽象 定义 聚集 在 一 起 。 
service: 元 素 包含 一 系列 的 port 子 元 素 ,port 子 元 素 将 会 把 绑 定 机 制 、 服 务 访 问 协 
议和 端点 地 址 结合 在 一 起 。 


一 般 来 说 ,只 要 调用 者 能 够 获取 Web 服务 对 应 的 WSDL ,就 可 以 从 中 了 解 它 所 提供 的 
服务 以 及 如 何 调 用 Web 服务 。 因 为 一 份 WSDL 文件 清晰 地 定义 了 以 下 三 个 方面 的 内 容 。 


WHAT 部 分 : 用 于 定义 Web 服务 所 提供 的 操作 (或 方法 ) ,也 就 是 Web 服务 能 做 些 
什么 。 由 WSDL 中 的 types, message 和 port Type 元 素 定义 。 

HOW 部 分 : 用 于 定义 如 何 访 问 Web 服务 ,包括 数据 格式 详情 和 访问 Web 服务 操 
作 的 必要 协议 。 也 就 是 定义 了 如 何 访 问 Web 服务 。 由 binding 元 素 定 义 。 
WHERE 部 分 : 用 于 定义 Web 服务 位 于 何 处 ,如 何 使 用 特定 协议 决定 的 网 络 地 址 
(如 URL) 指 定 。 该 部 分 由 service 元 素 定义 ,可 在 WSDL 文档 的 最 后 部 分 看 到 
service 元 素 。 


以 下 是 中 国 气 象 局 Web 服务 的 WSDL 文档 框架 : 
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01 <wsdl:definitions xmlns:soap = "http://schemas.xmlsoap.org/wsdl/soap/" 


02 xmlns:tm= "http://microsoft. com/wsdl/mime/textMatching/" 
03 xmlns: soapenc = "http://schemas. xmlsoap. org/soap/encoding/" 
04 xnlns:mime = "http://schemas. xmlsoap. org/wsdl/mime/" 

05 xmlns:tns = "http: //WebXm1l. com. cn/" 

06 xmlns:s= "http://www. w3. org/2001/XMLSchena" 

07 xmlns: soap12 = "http: //schemas. xmlsoap. org/wsdl/soap12/" 
08 xmlns: http = "http: //schemas. xmlsoap. org/wsdl/http/" 

09 xmlns:wsdl = "http: //schemas. xmlsoap. org/wsdl/" 

10 targetNamespace = "http: / /WebXnl. com. cn/"> 

11 cs 

12 «wsdl:types > 

13 < s:schema elementFormDefault = "qualified" 

14 targetNamespace = "http: //WebXm1. com. cn/"> 

15 X s: element name = "getSupportCity"> 

16 <s:complexType > 

17 <s:sequence> 

18 <s:element minOccurs = "0" maxOccurs = "1" 
19 name = "byProvinceName" type = "s:string"/> 
20 </s:sequence > 

21 </s:complexType > 

22 </s: element > 

23 </wsdl : types > 

24 < wsdl:service name = "WeatherWebService"> 

25 <wsd1: port name = "WeatherWebServiceHttpPost" 

26 binding = "tns:WeatherWebServiceHttpPost"» 

27 <http:address location = "http://www. webxml. com. cn/ 
28 WebServices/WeatherWebService. asmx"/> 

29 </wsdl: port > 

30 </wsdl:service > 


31 </wsdl:definitions > 


其 中 ,types 元 素 使 用 XML 模式 语言 声明 在 WSDL 文档 中 的 其 他 位 置 使 用 的 复杂 数 
据 类 型 与 元 素 ; import 元 素 类 似 于 XML 模式 文档 中 的 import 元 素 , 用 于 从 其 他 WSDL x 
档 中 导入 WSDL 定义 ; message 元 素 使 用 在 WSDL 文档 的 type 元 素 中 定义 或 在 外 部 
WSDL 文档 中 定义 的 XML 模式 的 内 置 类 型 复杂 类 型 或 元 素描 述 了 消息 的 有 效 负载 ; 
portType 元 素 和 operation 元 素描 述 了 Web 服务 的 接口 并 定义 了 它 的 方法 。portType 元 
素 和 operation 元 素 类 似 于 Java 接口 和 接口 中 定义 的 方法 声明 。operation 元 素 使 用 一 个 或 
者 多 个 message 类 型 来 定义 它 的 输入 和 输出 的 有 效 负载 ， Binding 元 素 将 portType 元 素 和 
operation 元 素 赋 给 一 个 特殊 的 协议 和 编码 样式 ; service 元 素 负责 将 Internet 地 址 赋 给 一 
个 具体 的 绑 定 。 

3. UDDI 

UDDICUniversal Description, Discovery and Integration ,统一 描述 发现 和 集成 ) 是 一 
套 基于 Web 的 、 分 布 式 的 ,为 Web 服务 提供 的 信息 注册 中 心 的 实现 标准 规范 ,同时 也 包含 一 组 
使 企业 能 将 自身 提供 的 Web 服务 注册 以 使 得 别 的 企业 能 够 发 现 的 访问 协议 的 实现 标准 。 

UDDI 同时 也 是 Web 服务 集成 的 一 个 体系 框架 。 它 包含 了 服务 描述 与 发 现 的 标准 规 
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Wi. UDDI 规范 利用 了 W3C 和 Internet 工程 任务 组 织 的 很 多 标准 作为 其 实现 基础 ,例如 
XML 语言 HTTP 和 域名 服务 等 协议 。 另 外 ,在 跨 平台 的 设计 特性 中 , UDDI 主要 采用 了 
SOAP 进行 通信 。 

UDDI 包 含 于 完整 的 Web 服务 协议 栈 内 ,而 且 是 协议 栈 基础 的 主要 部 件 之 一 ,支持 创 





WSDL 


SOAP 


http. fip» MQ. 
IIOP and more 





XML-based messaging 








LA RAL Web 服务 ,如 图 7-2 所 示 。 


WSFL Service flow 
7-2 UDDI 的 分 层 Web 服务 协议 栈 





UDDI 实现 了 一 组 可 公开 访问 的 接口 ,通过 这 些 接 口 ,网 络 服务 可 以 向 服务 信息 库 注册 
其 服务 信息 、 服 务 需 求 者 可 以 找到 分 散在 世界 各 地 的 网 络 服务 。 

UDDI 的 核心 是 其 注册 机 制 。UDDI 注册 中 心包 含 了 通过 程序 手段 可 以 访问 到 的 对 企 
业 和 企业 支持 的 服务 所 做 的 描述 。 此 外 ,还 包含 对 Web 服务 所 支持 的 因 行业 而 异 的 规范 、 
分 类 法 定义 (用 于 对 于 企业 和 服务 很 重要 的 类 别 ) 以 及 标识 系统 (用 于 对 于 企业 很 重要 的 标 
识 ) 的 引用 。UDDI 提供 了 一 种 编程 模型 和 模式 , 它 定义 与 注册 中 心 通信 的 规则 。UDDI 规 
范 中 所 有 API 都 用 XML 来 定义 ,包装 在 SOAP 信封 中 ,在 HTTP 上 传输 。UDDI 的 工作 
原理 如 图 7-3 所 示 。 


UDDI and SOAP 





Client 


UDDI SOAP request. 


UDDI registry node 





SSL for save_xxx 






HTTP server E SOAP server 








UDDI SOAP response 
Process UDDI API request 


Registry data 


图 7-3 UDDI 消息 在 客户 机 和 注册 中 心 之 间 的 流动 








Create, view. update 
and delete registrations 


Implementation 
neutral 
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7-3 说 明了 UDDI 消息 的 传输 过 程 : 通过 HTTP 从 客户 机 的 SOAP 请 求 传 到 注册 
中 心 节点 ,然后 再 反 向 传输 。 注 册 中 心服 务 器 的 SOAP 服务 器 接收 UDDI SOAP 消息 并 进 
行 处 理 , 然 后 把 SOAP 响应 返回 给 客户 机 。 对 注册 中 心 来 说 ,客户 机 发 出 的 要 修改 数据 的 
请 求 必须 确保 是 安全 的 \ 经 过 验证 的 事务 。 


7.1.3 Ksoap2 编程 


在 Android SDK 中 并 没有 提供 调用 Web 服务 的 库 , 因 此 需要 使 用 第 三 方 类 库 来 调用 
Web 服务 。Google 为 Android 平台 开发 Web 服务 客户 端 提供 了 ksoap2-android Ji HO, © 
Æ Android 平台 上 一 个 高 效 、 轻 量 级 的 SOAP 开发 包 , 但 这 个 项 目 并 未 直接 集成 在 Android 
平台 中 ,需要 开发 人 员 自行 下 载 。 

下 面 以 一 个 查询 电话 号 码 归属 地 的 Web 服务 为 例 ,来 分 析 Android 中 基于 Ksoap 编程 
的 基本 步骤。 该 Web 服务 终端 如 图 7-4 所 示 。 


MobileCodeWS 


WebXml.com.cn 国内 手机 号 码 归属 地 查 调 W EB 服 务 ， 提 供 最 新 的 国内 手机 号 码 段 / 属 地 数据 ， 每 月 更 新 。 
使 用 本 站 WEB 服务 请 注 明 或 链接 本 站 : http:/ /www.webxml.com.cn/ 感谢 大 家 的 支持 ! 


支持 下 列 操作 。 有 关 正 式 定义 ,请 查看 服务 谥 明 。 


* getDatabaseInfo 
获得 国内 手机 号 码 归 属地 教 据 库 信 息 
输入 参数 : 无 ! 返回 数据 : AFERRA (GH 城市 记录 数量 ) 。 
* getMobileCodeInfo 
获得 国内 手机 号 码 归 属地 省 份 、 地 区 和 手机 卡 类 型 信息 


MASM: mobileCode = FAR (手机 吕 码 ， 最 少 前 7 位 数字 ) » userlD = FFR 《商业 用 户 ID〉 免费 用 户 为 空 字 
符 串 ; 返回 数据 : FER (FUSO: 省 份 城市 手机 卡 类 型 ) 。 








图 7-4 号 码 归属 地 Web 服务 端 


单 击 其 中 的 getMobileCodelnfo 方法 链接 ,在 新 打开 页 面 的 测试 区 域 输入 mobileCode 
参数 ,并 单 击 “ 调 用 ”按钮 ,显示 如 图 7-5 所 示 的 响应 XML 数据 信息 。 


This XML file does not appear to have any style information associated with it. 
The document tree is shown below. 


string xnlns="http://Webžnl. com cr/" 513400013235: 江苏 南京 江苏 移动 大 众 卡 人 /string> 
图 7-5 getMobileCodeInfo 方法 响应 信息 
(D 创建 Android 项 目 , 并 在 项 目的 libs 中 导入 ksoap2-android 包 ( 当 前 版 本 ksoap2- 
android-assembly-3. 4. 0-jar-with-dependencies. jar) 。 
@ 创建 Web 服务 工具 类 ,如 WebServiceUtil, 并 指定 Web 服务 的 命名 空间 、 服 务 端点 、 
调用 方法 名 称 。 例 如 : 


© WHER: https://code. google. com/p/ksoap2-android. 
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01 String nameSpace = "http://WebXnl.con.cn/" ; 

02 String methodName = "getMobileCodeInfo"; 

03 String endPoint = 

04 "http: //webservice. webxml. com. cn/WebServices/MobileCodeWS. asmx"; 


@ 创建 SoapObject 对 象 ,创建 该 对 象 时 需要 传人 所 要 调用 WebService 的 命名 空间 、 
WebService 方法 名 。 例 如 : 


01 SoapObject rpc = new SoapObject(nameSpace, methodName); 


@ 如 果 有 参数 需要 传 给 WebService 服务 器 端 ,调用 SoapObject 对 象 的 addProperty 
(Stringname, Object value) 方 法 来 设置 参数 ,该 方法 的 name 参数 指定 参数 名 ; value 参数 
指定 参数 值 。 本 例 中 ,两 个 参数 mobileCode、userld 不 可 以 随便 写 ,必须 和 提供 的 参数 名 相 
同 。 例 如 : 


01 rpc.addProperty("mobileCode", phoneSec); 
02 rpc.addProperty("userId", ""); 


© i) # SoapSerializationEnvelope Xf ££, SoapSerializationEnvelope 是 一 个 SOAP 消 
BE. Æ ksoap2-android 项 目 中 , 它 是 HttpTransportSE 调用 WebService 时 信息 的 载 
体 , 客 户 端 传人 的 参数 需要 通过 SoapSerializationEnvelope Xf ££ fff bodyOut 属性 传 给 服务 
器 ; 服务 器 响应 生成 的 SOAP 消息 也 通过 该 对 象 的 bodyIn 属性 来 获取 。 例 如 : 


01 SoapSerializationEnvelope envelope = new SoapSerializationEnvelope( 
02 SoapEnvelope. VER12); 


© 调用 SoapSerializationEnvelope 的 setOutputSoapObject ( ) 方法 ,或 者 直接 对 
bodyOut 属性 赋值 ,将 SoapObject 对 象 设 为 SoapSerializationEnvelope 的 传 出 SOAP 消息 
体 。 例 如 : 

01 envelope. bodyOut = rpc; 


02 envelope. dotNet = true; // 设 置 是 否 调用 的 是 dotNet 开发 的 WebService 
03 envelope. setOutputSoapObject(rpc); //4 t F envelope.bodyOut = rpc 


@ 创建 HttpTransportSE 对 象 ,该 对 象 用 于 调用 WebService 操作 。 例 如 : 

01 HttpTransportSE transport = new HttpTransportSE(endPoint); 

调用 HttpTransportSE 对 象 的 call() 方 法 ,并 以 SoapSerializationEnvelope 作为 参 
数 调用 远程 Web 服务 。 例 如 : 

01 try{ 

02 transport.call(nameSpace * methodName, envelope); 


03 } catch (Exception e) { 
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04 
05 


e. printStackTrace(); 


] 


© 调用 完成 后 ,访问 SoapSerializationEnvelope 对 象 的 bodyln 属性 ,该 属性 返回 一 个 
SoapObject 对 象 ,该 对 象 就 代表 了 Web 服务 的 返回 消息 。 解 析 该 SoapObject 对 象 , 即 可 获 
取 调 用 Web 服务 的 返回 值 。 例 如 : 


01 


SoapObject object = (SoapObject) envelope. bodyIn; 


02 String result = object. getProperty("getMobileCodeInfoResult"). toString(); 


下 面 给 出 一 个 完整 的 获取 天 气 预报 信息 的 Web 服务 客户 端 工具 类 ,代码 如 下 : 


01 public class WeatherWebServiceReader { 
public static final String SERVICE NS = "http://WebXml.com.cn/"; 
public static final String SERVICE URL - 


02 
03 
04 
05 
06 
07 
08 
09 
10 
[ET 
12 
13 
14 
15 
16 
a7 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 


/*x 
x 
x 


* 


"http: //webservice. webxnl. com. cn/WebServices/WeatherWS. asmx" ; 


此 方法 用 于 通过 WebService 获取 省 份 列 表 , 服 务 的 方法 名 字 为 "getRegionProvince" 


@return List< String> 返回 省 份 列表 集合 


x/ 
public static ArrayList < String  getProvince() { 


/x* 


* 


ArrayList < String > provinces = null; 
String methodName - "getRegionProvince"; 
HttpTransportSE ht - new HttpTransportSE(SERVICE URL, 30000); 
SoapSerializationEnvelope envelope - new SoapSerializationEnvelope( 
SoapEnvelope. VER12); 
SoapObject soapRequest = new SoapObject(SERVICE NS, methodName) ; 
envelope.bodyOut = soapRequest; 
envelope. dotNet = false; 
try { 
ht.call(SERVICE_NS + methodName, envelope) ; 
if (envelope. getResponse() != null) { 
SoapObject detail = (SoapObject) envelope. bodyIn; 
provinces = getProvinceOrCity( detail) ; 
} 
} catch (IOException e) { 
e. printStackTrace( ) ; 
} catch (XnlPullParserException e) { 
e. printStackTrace(); 
) 


return provinces; 


此 方法 用 于 根据 WebService 响应 的 服务 解析 出 省 份 对 象 集合 或 者 指定 省 份 下 属 城市 集合 
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37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 


@param detail 

SoapObject 表示 WebService 服务 响应 的 SoapObject 对 象 
* @return ArrayList <String> 返回 值 表示 省 份 名 称 集合 ,或 者 城市 名 称 集合 
x/ 


SOS xm 


public static ArrayList < String > getProvinceOrCity(SoapObject detail) ( 


ArrayList < String> result = new ArrayList < String >(); 

System. out. print1n( detail. toString()); 

String resultResponse = detail. toString(); 

resultResponse = resultResponse. substring( 
resultResponse. indexOf("anyType(") + 8, 
resultResponse. lastIndex0f("};")); 

String[ ] nameList = resultResponse. split(" "); 

for (int i = 0; i<nameList. length; i++) ( 

result. add(nameList[ i]. substring(nameList[i].indexOf(" 2") + 1, 
naneList[i].indexOf(","))); 
} 


return result; 


* 
* 


此 方法 用 于 通过 向 WebService 发 送 省 份 名 称 获得 该 省 市 相关 的 城市 集合 
服务 方法 名 称 为 getSupportCityString 


@paran province 

String 表示 指定 省 份 名 称 
@return ArrayList < String> 指定 省 市 相关 的 集合 
x/ 


fo 49 d» xy ois 


* 


public static ArrayList < String > getCitiesByProvinceName( 


String provinceName) { 
ArrayList < String» cities = null; 
String methodName = "getSupportCityString"; 
HttpTransportSE ht = new HttpTransportSE(SERVICE URL, 30000); 
SoapSerializationEnvelope envelope - new SoapSerializationEnvelope( 
SoapEnvelope. VER12); 
SoapObject soapRequest = new SoapObject(SERVICE NS, methodName) ; 
soapRequest. addProperty(" theRegionCode", provinceName); 
envelope.bodyOut = soapRequest; 
envelope. dotNet = false; 
try { 
ht.call(SERVICE NS + methodName, envelope); 
if (envelope. getResponse() != null) ( 
SoapObject detail = (SoapObject) envelope. bodyIn; 
cities = getProvinceOrCity(detail) ; 
} 
} catch (IOException e) { 
e. printStackTrace( ) ; 
} catch (XnlPullParserException e) { 
e. printStackTrace(); 
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119 


} 


/xx 


* 


* 


* 


* 
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} 


return cities; 


此 方法 用 于 根据 城市 名 称 获得 天 气 预 报 WebService 提供 的 详细 天 气 气象 信息 
服务 方法 名 称 为 theCityCode 


(à param cityName 
String 表示 指定 的 城市 名 称 
(9) return SoapObject 返回 SoapObject 对 象 表示 城市 气象 信息 的 Soap 消息 对 象 


x/ 
public static SoapObject getWeatherByCity(String cityName) ( 


SoapObject weatherDetail = null; 

String methodName - "getWeather"; 

HttpTransportSE ht - new HttpTransportSE(SERVICE URL, 30000); 

SoapSerializationEnvelope envelope - new SoapSerializationEnvelope( 

SoapEnvelope. VER12); 

SoapObject soapRequest = new SoapObject(SERVICE NS, methodName); 

soapRequest. addProperty("theCityCode", cityName); 

envelope.bodyOut - soapRequest; 

envelope.dotNet - false; 

try { 
ht.call(SERVICE_NS + methodName, envelope) ; 
if (envelope. getResponse() != null) { 

weatherDetail = (SoapObject) envelope. bodyIn; 

} 

} catch (IOException e) { 
e. printStackTrace( ) ; 

} catch (XnlPullParserException e) ( 
e. printStackTrace( ) ; 

} 

return weatherDetail; 


7.2 开放 接口 编程 


开放 平台 是 互联 网 发 展 的 新 趋势 ,其 建设 思想 在 于 将 网 站 提供 的 服务 封装 成 一 系列 对 
外 开放 的 计算 机 编程 数据 接口 ,提供 给 第 三 方 开发 者 使 用 ,第 三 方 开发 者 通过 这 些 开放 接口 
开发 丰富 多 彩 的 应 用 ,并 以 此 获得 可 观 的 社会 效益 和 经 济 利益 。 


7.2.1 


开放 平台 概述 


在 互联 网 时 代 ,把 网 站 的 服务 封装 成 一 系列 计算 机 易 识 别 的 数据 接口 开放 出 去 , 供 第 三 
方 开发 者 使 用 ,这 种 行为 就 叫 作 开放 API, 提 供 开 放 API 的 平台 被 称 为 开放 平台 。 通 过 开 
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放 平 台 , 网 站 不 仅 能 提供 对 Web 网 页 的 简单 访问 ,还 可 以 进行 复杂 的 数据 交互 ,将 它们 的 
Web 网 站 转换 为 与 操作 系统 等 价 的 开发 平台 。 

Facebook 的 成 功 展示 了 开放 平台 的 巨大 潜力 。 从 2008 年 开始 ,人 人 网 和 淘宝 网 推出 
自己 的 开放 平台 计划 。 到 2010 年 ,新 浪 微 博 、 百 度 、 盛 大 、 开 心 网 、 腾 讯 .、360 等 国内 互联 网 
企业 相继 尝试 开放 部 分 自己 产品 服务 与 数据 的 API, 展 开 与 第 三 方 开发 者 的 争夺 战 。 

国内 主流 开放 平台 积极 布局 SNS(Social Network Site, 即 社交 网 站 )、 搜 索 、 电 商 、 桌 
面 、 微 博 。 人 人 网 发 展 社区 应 用 、 新 浪 微 博 主 打 内 容 开 放 、 淘 宝 网 发 展 电子 商 务 应 用 、 腾 讯 发 
展 多 维度 平台 、 百 度 主打 Web 应 用 、360 发 展 多 客户 端 应 用 等 。 

开放 平台 实现 了 应 用 开放 、 横 向 开放 和 数据 开放 。 应 用 开放 是 开放 自身 平台 的 各 种 标 
准 接口 ,欢迎 第 三 方 提供 各 类 应 用 ,共享 用 户 , 共 同 服务 。 横 向 开放 是 开放 平台 本 身 欢 迎 第 
三 方 平台 或 网 站 互联 互通 ,让 用 户 在 不 同 平 台 和 网 站 间 畅 通 无 阻 。 数 据 开 放 是 在 保护 用 户 
隐私 前 提 下 ,开放 用 户 基 本 数据 ,关系 数据 和 行为 数据 , 同 第 三 方 一 起 打造 个 性 化 个 人 化 、 
智能 化 、 实 时 化 的 服务 模式 。 

开放 平台 运营 商 根据 核心 业务 定位 确定 开放 尺度 。 在 开放 平台 大 潮 中 ,互联 网 企业 开 
放 到 何 种 程度 ,开放 政策 如 何 制定 ,开放 底线 在 哪里 ,归根 结 底 取决 于 企业 的 业务 定位 以 及 
核心 竞争 力 。 

一 利 模式 决定 了 平台 是 否 开放 以 及 开放 的 程度 。 一 类 开放 平台 自己 不 创造 内 容 , 它 们 
是 真正 的 平台 角色 ,让 信息 供给 者 、 广 告 供给 者 \ 信 息 消 费 者 在 自己 的 服务 中 云集 ,自己 从 中 
获取 收益 。 另 一 类 开放 平台 利用 互联 网 增值 服务 ,包括 网 游 和 虚拟 物品 售卖 等 鳃 利 , 开 放 是 
为 了 利用 开发 者 贡献 的 内 容 吸 引 更 多 用 户 ,增加 用 户 黏 性 ,从 而 进一步 巩固 在 核心 业务 的 控 
制 地 位 ,保持 长 期 盈利 的 能 力 。 

作为 开发 者 ,首要 考虑 的 还 是 接口 用 户 需求 和 收益 分 成 ,对 于 不 同 的 开放 平台 ,开发 者 
和 服务 商 之 间 的 分 成 没有 统一 的 分 配 。 


7.2.2 OAuth 授权 


为 了 安全 地 访问 在 线 服务 ,用户 需 要 在 服务 上 进行 身份 验证 , 即 要 提供 其 身份 证 明 。 对 
于 一 个 要 访问 第 三 方 服务 的 程序 来 说 ,安全 问题 甚至 更 复杂 。 不 仅仅 是 用 户 需 要 在 访问 服 
务 前 进行 身份 验证 ,而 且 程 序 也 要 进行 身份 验证 来 授权 用 户 。 

1. OAuth 与 OAuth 2.0 

OAuth 是 一 个 分 布 式 身份 验证 和 授权 的 开放 标准 , 它 于 2006 年 由 Twitter 和 业务 合作 
伙伴 Ma. gnolia 开发 ,用 来 方便 地 创建 一 些 桌 面 小 部 件 ,这 些小 部 件 允 许 第 三 方 应 用 在 用 户 
授权 的 情况 下 访问 其 在 网 站 上 存储 的 信息 资源 ,而 这 一 过 程 中 网 站 无 须 将 用 户 的 账号 密码 
告诉 第 三 方 应 用 。 

OAuth 的 设计 思路 是 在 “客户 端 ” 与 “服务 提供 商 ” 之 间 设 置 一 个 授权 层 (authorization 
layer 。“ 客 户 端 ”不 能 直接 登录 “服务 提供 商 ”, 只 能 登录 授权 层 , 以 此 将 用 户 与 客户 端 区 分 
开 来 。“ 客 户 端 ” 登 录 授 权 层 所 用 的 令 牌 (token), 与 用 户 的 密码 不 同 。 用 户 可 以 在 登录 时 ， 
指定 授权 层 令 牌 的 权限 范围 和 有 效 期 。“ 客 户 端 "登录 授权 层 以 后 ,“ 服 务 提供 商 ” 根 据 令 牌 
的 权限 范围 和 有 效 期 ,向 “客户 端 " 开 放 用 户 储存 的 资料 。 

OAuth 2. 0 是 OAuth 协议 的 当前 版 本 。OAuth 2. 0 提供 一 个 单 值 , 叫 作 认证 令 牌 
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(auth token) ,代表 用 户 身份 和 程序 身份 验证 授权 。OAuth 2. 0 针对 1.0 版 本 存在 的 各 种 问 
题 提出 了 如 下 解决 方案 : 

。 OAuth 2.0 提出 了 多 种 流程 ,各 个 客户 端 按照 实际 情况 选择 不 同 的 流程 来 获取 
access_token。 这 样 就 解决 了 对 移动 设备 等 第 三 方 的 支持 ,也 解决 了 拓展 性 的 问题 。 

。 OAuth 2.0 删除 了 烦琐 的 加 密 算法 。 利 用 https 传输 保证 了 认证 的 安全 性 。 

。 OAuth 2.0 的 认证 流程 一 般 只 有 两 步 ,对 开发 者 来 说 减轻 了 其 负担 。 

。 OAuth 2.0 提出 了 access_token 的 更 新 方案 ,获取 access_token 的 同时 也 获取 
refresh token, access token 是 有 过 期 时 间 的 ,refresh_token 的 过 期 时 间 较 长 ,这 
样 能 随时 使 用 refresh. token 对 access token 进行 更 新 。 

7-6 为 人 人 网 基于 OAuth 2.0 实现 授权 的 示例 。 
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图 7-6 人 人 网 OAuth 2. 0 授权 示例 


2. Android 中 的 OAuth 授权 流程 

OAuth 2. 0 的 授权 流程 一 般 为 ， 

(D 用 户 打开 客户 端 以 后 ,客户 端 要 求 用 户 给 予 授权 。 

@ 用 户 同意 给 客户 端 授权 。 

© 客户 端 使 用 上 一 步 获得 的 授权 ,向 认证 服务 器 申请 令 牌 。 

® 认证 服务 器 对 客户 端 进行 认证 以 后 ,确认 无 误 ,同意 发 放 令 牌 。 

© 客户 端 使 用 令 牌 ,向 资源 服务 器 申请 获取 资源 。 

© 资源 服务 器 确认 令 牌 无 误 , 同 意向 客户 端 开放 资源 。 

7-7 演示 了 Android 平台 向 Google 服务 器 请 求 一 个 验证 令 牌 的 流程 : 

为 了 得 到 一 个 验证 令 牌 ,首先 需要 在 AndroidManifest 文件 中 添加 ACCOUNT _ 
MANAGER 权限 (为 了 访问 网 络 ,也 必须 添加 INTERNET 权限 ), 例 如 : 


01 <uses - permission android:name = "android. permission. ACCOUNT MANAGER" /> 
02 «uses- permission android:name = "android. permission. INTERNET" /> 
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图 7-7 获取 令 牌 流程 


调用 AccountManager. getAuthToken() 方 法 来 获取 令 牌 。 由 于 获取 令 牌 的 过 程 需要 
设计 网 络 访问 ,因此 ,AccountManager 中 的 方法 都 是 异步 的 ,并 且 获 得 令 牌 的 过 程 往往 通 
过 多 个 回调 方法 来 完成 ,例如 : 


01 AccountManager am = AccountManager.get(this); 


02 
03 
04 
05 
06 
07 
08 
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Bundle options - 


am. getAuthToken( 
myAccount , 
"Manage your tasks", 
options, 
this, 


new Bundle(); 


// 用 getAccountsByType( ) 来 检索 的 账户 
// 令 牌 范围 

// 特 殊 验 证 选项 

//Activity 





第 7 章 开放 接口 编程 





09 new OnTokenAcquired(), // 成 功 获取 令 牌 后 调用 的 回调 方法 
10 new Handler(new OnError())); // 错 误 发 生 时 调用 的 回调 方法 


其 中 ,OnTokenAcquired 是 一 个 继承 自 AccountManagerCallback 的 类 。AccountManager 
在 OnTokenAcquired 中 调用 run () 方 法 ,该 方法 需要 传递 一 个 含有 一 个 Bundle 的 
AccountManagerFuture 实例 。 如 果 调 用 成 功 ,那么 令 牌 中 就 会 包含 这 个 Bundle。 

下 面 的 代码 演示 了 从 Bundle 中 获取 令 牌 的 方法 : 


01 private class OnTokenAcquired implements AccountManagerCallback < Bundle > { 
02 @Override 


03 public void run(AccountManagerFuture < Bundle > result) { 

04 //Get the result of the operation from the AccountManagerFuture. 
05 Bundle bundle = result. getResult(); 

06 

07 //The token is a named value in the bundle. The name of the value 
08 //is stored in the constant AccountManager. KEY_AUTHTOKEN. 

09 token = bundle. getString(AccountManager. KEY_AUTHTOKEN) ; 


7.2.3 人 人 网 编程 


人 人 网 开放 平台 (http://dev. renren. com/) 提 供 了 一 种 新 的 接口 调用 方式 ,允许 被 人 
人 网 用 户 授 予 权 限 的 第 三 方 应 用 以 人 人 网 用 户 的 身份 来 读 写 人 人 网 的 资源 (例如 用 户 基 本 
资料 、 好 友 关 系 、 照 片 等 ) 。 

使 用 人 人 网 账号 登录 移动 客户 端 , 并 利用 人 人 网 开放 平台 提供 的 社交 图 谱 (Social 
Graph) 和 传播 渠道 ,增进 用 户 与 好 友 的 交互 ,提升 使 用 体验 ,并 获得 广泛 传播 。 

Android 手机 客户 端 接 人 人 人 网 ,可 以 有 两 种 实现 方式 : 一 种 是 直接 使 用 人 人 网 开放 
平台 提供 的 各 种 接口 ,如 用 作 验 证 和 授权 的 OAuth 2.0, 提 供 数据 的 底层 Rest API, EUR iR 
人 各 种 Widget; 另 一 种 是 使 用 人 人 网 开放 平台 官方 封装 的 开源 Android SDK 。 

1. 创建 应 用 

创建 人 人 网 应 用 首先 需要 一 个 人 人 网 账号 ,如 果 没 有 人 人 网 账户 ,可 以 先 去 注册 一 个 。 
登录 后 输入 dev. renren. com 进入 人 人 网 开放 平台 页 面 ,点 击 “ 我 的 应 用 ”进入 应 用 管理 中 
心 。 这 时 需要 进行 开发 者 身份 认证 ,填写 完 开发 者 认证 信息 后 ,开放 平台 会 给 注册 邮箱 发 送 
一 封 认证 邮件 。 点 击 认证 链接 后 完成 开发 者 身份 认证 返回 应 用 中 心 。 这 时 就 是 一 名 经 过 认 
证 的 开发 者 了 。 

成 为 一 个 开发 者 后 ,可 以 按照 图 7-8 的 流程 使 用 人 人 网 开发 平台 。 

点 击 界面 上 的 “创建 应 用 ”按钮 ,这 时 会 进入 基本 信息 页 面 ,需要 正确 并 完整 地 填写 基本 
信息 之 后 , 才 可 以 创建 应 用 ,如 图 7-9 所 示 。 

按照 界面 提示 步骤 ,一 步 一 步 完成 应 用 的 创建 后 ,将 获得 APP ID, API KEY 和 Secret 
Key. 
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注册 应 用 











用 户 授权 后 返回 
给 网 站 授权 码 


Authorization Code 


Y 
获取 











获取 


Access Token 








创建 应 用 


* 应 用 名 称 [2]: 
“应 用 分 类 [7]: 
“应 用 根 域名 填写 [?]: 
“应 用 简介 [?]: 


“EREHE: 
应 用 关键 词 [?]: 


应 用 图 标 


+ 图 标 16*16 px [7]: 


* 图 标 48*48 px [?]: 


2. 基于 SDK 开发 应 用 


本 节 使 用 人 人 网 Android SDK 来 实现 发 布 一 张 手 机 图 片 到 人 人 网 的 功能 。 有 关 
Android 手机 客户 端 应 用 接 入 方式 的 详细 信息 可 以 参考 人 人 网 的 维基 (http://wiki. dev. 








1 
提交 审核 











图 7-8 创建 应 用 流程 


请 选择 Y 


用 户 点 击 * 人 人 登录 "按钮 跳 
转 到 人 人 网 的 登录 授权 页 面 


通过 授权 码 获 得 用 户 的 Access 
Token 完 成 登录 授权 的 操作 





请 选择 y 





15 个 字 以 内 


GER 


Lx | 


图 7-9 创建 应 用 界面 


renren. com/ wiki/ 移 动 客户 端 接 人 ) 。 


下 面 介绍 通过 自 定 义 的 图 片上 传 服务 UploadPictureService 文件 实现 图 片上 传 的 功 
能 。 步 又 如 下 : 
(D 在 Eclipse 中 导入 从 https://bitbucket. org/renren_platform/ 下 载 的 SDK Mi H 


renren android connect, 


© 在 应 用 项 目的 Properties 对 话 框 中 添加 renren. android connect Library. 
注意 : 在 Windows 系统 下 ,library project 必须 和 project 处 于 相同 的 盘 符 中 ,因为 如 果 
用 了 不 同 的 盘 符 ,project. properties 中 的 android. library. reference. 1 值 变 成 绝对 路 径 , 而 


ADT 推荐 的 是 在 ubuntu 下 使 用 ,对 Windows 绝对 路 径 的 支持 有 错误 。 
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@ 在 上 传 图 片 的 Activity 的 onCreate() 方 法 中 初始 化 Renren 对 象 ,开发 者 可 以 使 用 
该 类 调用 人 人 网 提供 的 网 络 接口 。 例 如 : 


01 renren = new Renren(API KEY, SECRET KEY, APP ID, this); 


其 中 的 API KEY,SECRET KEY 和 APP ID 即 为 创建 应 用 时 获取 的 信息 。 
® 创建 AsyncTask 实现 类 异步 处 理 图 片上 传 ,核心 代码 如 下 : 


01 class UploadTask extends AsyncTask < String, Integer, String> ( 
02 

03 @Override 

04 protected String doInBackground(String... params) { 


05 try { 

06 Looper. prepare( ) ; 

07 renren. authorize(RenRenActivity. this, renRenAuthListener) ; 
08 Looper. loop( ) ; 

09 } catch (Exception e) { 
10 e.printStackTrace(); 
11 } 

12 return null; 

13 } 

14 

15 

16 ) 


© 实现 监听 认证 和 授权 动作 的 RenrenAuthListener ,代码 如 下 : 


01 private RenrenAuthListener renRenAuthListener = new RenrenAuthListener() ( 
02 @Override 
03 public void onComplete(Bundle values) { 


04 Log. d(TAG, "Auth ok."); 

05 // 待 上 传 图 片 的 路 径 

06 final String imagePath = getImageAbsolutePath( uri) ; 

07 try { 

08 AlbumGetResponseBean beans = renren.getAlbums(null); 
09 if (beans == null) ( 

10 noRenRenAlbums( imagePath) ; 

iut } else ( 

12 List < AlbumBean > beanList = beans. getAlbums() ; 
13 showRenRenAlbums(beanList, imagePath) ; 

14 } 

15 } catch (RenrenException e) { 

16 e. printStackTrace(); 

17 } catch (Throwable e) { 

18 e. printStackTrace( ) ; 

19 } 

20 

21 } 
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23 @Override 

24 public void onRenrenAuthError(RenrenAuthError renrenAuthError) { 
25 renRenHandler. post(new Runnable() { 

26 (2 Override 

27 public void run() ( 

28 Toast.makeText(RenRenActivity. this, "认证 失败 "， 

29 Toast. LENGTH_SHORT) . show( ); 


31 n; 


34 @Override 
B5 public void onCancelLogin() { 
36 ) 


38 @Override 

39 public void onCancelAuth(Bundle values) { 
40 } 

41 bh 





其 中 ,08 行 的 AlbumGetResponseBean 封装 了 List AlbumBean>, Hi 3 


F 返 回 相册 列 


表 ( 图 7-10) 。 如 果 没 有 相册 列表 , 则 将 当前 图 片上 传 到 默认 目录 ,和 否则 显示 相册 列表 。 
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2015 年 5 月 11 日 
2012 年 5 月 1 日 


2012 年 3 月 11 日 


头像 相册 


取消 





7-10 相册 列表 
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实现 默认 相册 列表 的 上 传 ,代码 如 下 : 


01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
idi 
12 
13 
14 
15 
16 
iiri 
18 
19 
20 
21 
22 
23 
24 
25 


private void noRenRenAlbums(final String imagePath) ( 
AlertDialog. Builder builder = new AlertDialog.Builder( 
RenRenActivity.this); 
builder.setTitle("ik ££"); 
builder. setMessage(" 上 传 到 默认 相册 ?"); 
builder. setPositiveButton( "确定"， 
new DialogInterface. OnClickListener() { 
public void onClick(DialogInterface dialog, int id) { 
try { 
publishPhoto( - 1, imagePath) ; 
} catch (Throwable e) { 
Toast. makeText(getApplicationContext(), "Jd Hr E f£ 4c Wr", 
Toast. LENGTH SHORT).show(); 
e. printStackTrace(); 


H; 
builder. setNegativeButton(" 取 消 "， 
new DialogInterface. OnClickListener() { 
public void onClick(DialogInterface dialog, int id) ( 
} 
H; 
AlertDialog alert = builder.create(); 
alert. show() ; 


© 实现 指定 相册 的 上 传 ,代码 如 下 : 


01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19. 


private void showRenRenAlbums(final List < AlbumBean > beans, 

final String imagePath) ( 
int size = beans. size(); 
final String albums[] = new String[size]; 
for (int i = 0; i< size; i++) { 

albums[i] = beans. get(i).getName(); 
} 
selectedItem = 0; 
AlertDialog. Builder builder = new AlertDialog. Builder(this) ; 
builder. setTitle(" 选 择 人 人 网 相册 "); 
builder. setSingleChoiceItems(albums, 0, 

new DialogInterface. OnClickListener() { 
public void onClick(DialogInterface dialog, int item) { 
selectedItem = item; 


n; 
builder. setPositiveButton("#i7E", 
new DialogInterface. OnClickListener() { 
public void onClick(DialogInterface dialog, int id) { 
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20 try { 

2t publishPhoto(beans. get(selectedItem).getAid(), imagePath); 
22 ] catch (Throwable e) ( 

23 Toast.makeText(getApplicationContext(), "图 片上 传 失败 "， 
24 Toast. LENGTH SHORT).show(); 

25 e. printStackTrace(); 

26 } 

27 } 

28 H; 

29 builder. setNegativeButton(" 取 消 "， 

30 new DialogInterface. OnClickListener() ( 

31 public void onClick(DialogInterface dialog, int id) { 

32 } 

33 H; 

34 AlertDialog alert = builder. create( ); 

35 alert. show() ; 

36 F 


实现 图 片上 传 的 方法 publishPhotoO ,代码 如 下 : 


01 private void publishPhoto(long aid, String picPath) throws RenrenException, 


02 Throwable { 

03 

04 PhotoUploadRequestParam param; 

05 

06 File f = new File(picPath) ; 

07 

08 if (f. length() > 2097152) ( 

09 Bitmap resizeBmp - null; 

10 BitmapFactory. Options opts = new BitmapFactory.Options(); 
11 opts. inSampleSize = 10; 

12 resizeBmp - BitmapFactory.decodeFile(f.getPath(), opts); 
13 String extension = picPath. substring(picPath.lastIndexOf(".") + 1, 
14 picPath. length()). toLowerCase(); 

15 saveBitmapToSDCard(resizeBmp, "/sdcard/ tmp." * extension); 
16 param = new PhotoUploadRequestParam(new File("/sdcard/ tmp." 
irl * extension)); 

18 ) eise ( 

19 param - new PhotoUploadRequestParam(new File(picPath)); 

20 } 

21 

22 if (aid != -1) { 

23 param. setAid(aid); 

24 } 

25 if (renren. publishPhoto(param) == null) { 

26 Toast. makeText (getApplicationContext(), "图 片上 传 失 败 "， 

on Toast. LENGTH_SHORT) . show() ; 

28 } else { 

29 Toast. makeText(getApplicationContext(), "图 片上 传 成 功 "， 
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30 Toast.LENGTH SHORT).show(); 
31 ) 
32 ] 


其 中 ,04 行 的 PhotoUploadRequestParam 是 上 传 图 片 API 的 请 求 参数 bean, 08—18 fT 
是 对 大 尺寸 照片 的 处 理 技巧 ,避免 OOM 异常 。 


7.2.4 ”新浪 微 博 编 程 


新 浪 微 博 开放 平台 (http://open. weibo. com/index. php) 为 方便 移动 应 用 接 入 微 博 , 微 
博 平 台 提供 了 相关 接口 及 个 性 化 的 产品 结合 模式 ,并 不 断 优 化 微 博 移 动 端 解决 方案 ,提供 更 
多 定制 化 ` 个 性 化 服务 ,满足 了 多 元 化 移动 终端 用 户 随 时 随地 快速 登录 、 分 享 信息 的 需求 , 助 
力 实现 移动 Apps、 健 康 设备 .智能 家 居 车 载 等 多 类 型 终端 的 社会 化 接 人 。 

1 接 入 平台 

接 入 平台 的 整体 流程 如 图 7-11 所 示 。 





平台 网 站 | [Fama] [raso]. amez 
注册 移动 | >| 填写 应 用 | >] 下 载 SDK | | TEES | | 测试 上 线 


应 用 信息 iin is 



































7-11 SDK 接 入 流程 


(1) 注册 成 为 开发 者 ,创建 移动 应 用 。 

如 果 还 不 是 一 名 开发 者 , 先 注册 成 为 开发 者 (具体 参考 : http://open. weibo. com/ 
wiki/%E6% 96% B0 %E6 %89 %8B% E6 %8C%87 6 E5 968D9697) 。 

在 开发 者 页 面 单 击 “ 登 录 ” 或 者 “创建 应 用 ”, 通 过 账号 登录 成 为 一 名 开发 者 。 一 个 微 博 
账号 可 以 管理 10 个 不 同 的 应 用 ,建议 开发 人 员 使 用 官方 微 博 的 账号 ,以 便 统 一 管理 。 

单 击 “ 创 建 应 用 ”, 即 进入 目标 应 用 的 类 型 选择 环节 。 创 建 应 用 时 ,开发 者 需要 谨慎 选择 
应 用 对 应 平台 ,不 同 的 平台 建议 使 用 不 同 的 APP KEY 开发 。 

然后 在 开发 者 信息 设置 页 填写 真实 资料 ,成 为 微 博 认 证 的 开发 者 ,这 个 过 程 需 要 通过 邮 
箱 验 证 和 手机 验证 。 

(2) 获取 授权 。 

创建 应 用 完成 后 ,可 以 在 “我 的 应 用 -应 用 信息 ”页 面 中 查看 所 创建 应 用 的 APP KEY 及 
APP SECRET, 这 些 都 是 调用 微 博 开放 平台 各 API 的 身份 标志 。 

在 “我 的 应 用 -应 用 信息 -高 级 信息 ”页 面 中 填写 应 用 回调 页 (OAuth2.0 客户 端 默认 回调 
页 是 https://api. weibo. com/oauth2/default. html) ,这 样 才 能 使 OAuth2. 0 授权 正常 进 
行 。 如 果 APP SECRET 发 生 泄 露 ,也 可 以 通过 该 页 面 中 的 “ 重 置 ?按钮 对 其 重 置 。 

在 “我 的 应 用 -应 用 信息 ”页 面 中 填写 应 用 的 平台 信息 ,如 图 7-12 所 示 。 

Android 应 用 填写 包 名 、 签 名 及 下 载 地 址 (关于 各 字段 含义 在 控制 台中 均 有 说 明 ) 。 

2. 基于 SDK 开发 应 用 

本 节 以 sinaBlog® 的 实现 为 例 , 介 绍 基于 新 浪 微 博 开 放 平 台 的 移动 应 用 开发 技术 。 


© 项 目 主页 : https://github. com/NickAndroid/sinaBlog. 
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应 用 基本 信息 


ERAS. 。 普通 应 用 - EAA 
应 用 名 称 : 。 | 测试 安 齐 应 用 RERUN TAMER, Tii IIO 
应 用 平台 : (FR) 


(iPhone Android OBlackBery 
(Windows Phone C) Symbian 
口 webos Other 


"Androld 包 名 


*Androld 答 名 通过 下 载 使 用 平台 提供 的 签名 工具 获取 


*Androld 下 载 地址 


图 7-12 应 用 基本 信息 


在 介绍 具体 开发 步骤 前 , 先 了 解 几 个 微 博 核心 API 的 对 象 。 

。 Weibo: 微 博 API 接口 类 ,对 外 提供 Weibo API 的 调用 ,包括 登录 .API 调用 、 微 博 
分 享 等 功能 。 

* AsyncWeiboRunner: 微 博 API 异步 执行 类 ,封装 了 回调 接口 ,通过 创建 线程 来 调用 

Weibo 中 的 接口 方法 。 

Utility: 互联 网 工具 类 ,包括 接口 请 求 GET/POST 封装 .BASE64 等 encode, decode 

方法 。 

e WeiboException: 微 博 异常 封装 类 ,封装 了 微 博 的 各 个 异常 。 

(D 在 Eclipse 中 导入 微 博 官方 SDK (下载 地 址 为 https://github. com/sinaweibosdk/ 


weibo android sdk), 
@ 在 应 用 项 目的 Properties 对 话 框 中 添加 WeiboSDK. 
© ÆN Activity 的 onCreate() 方 法 中 初始 化 WeiboAuth 对 象 。 例 如 


01 mWeiboAuth = new WeiboAuth(this, com. bpok. sina. sdk. Constants. APP KEY, 
02 Constants. REDIRECT_URL, Constants. SCOPE) ; 


其 中 的 APP KEY 即 为 创建 应 用 时 获取 的 信息 , REDIRECT_URL 是 OAuth2. 0 客户 
端 默 认 回 调 页 ,SCOPE 是 OAuth2. 0 授权 机 制 中 authorize 接口 的 一 个 参数 (具体 参见 
http://open. weibo. com/wiki/Scope # scope. E8. AF. B4. E6. 98. 8E) 。 

有 时 为 了 自动 保存 登录 信息 ,需要 在 SharedPreferences 中 存储 上 次 已 保存 好 的 
AccessToken 等 信息 。 例 如 : 


01 Oauth2AccessToken mAccessToken; 
02 mAccessToken = AccessTokenKeeper. readAccessToken(this); 


其 中 ,OAuth2AccessToken 是 封装 Tokens 的 属性 类 ,继承 自 Token, 包含 Access 
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token,OAuth token secret 等 多 个 属性 。 
@ 创建 登录 Activity, 核 心 代码 如 下 : 


01 public class Login extends Activity ( 


02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35) 
36 
237 
38 
39 
40 
41 
42 
43 
44 
45 
46 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState) ; 
this. requestWindowFeature(Window. FEATURE NO TITLE); 
setContentView(R. layout. activity login); 
initLoginViews(); 


private void initLoginViews() { 
loginButton. setOnClickListener(new OnClickListener() ( 


@Override 

public void onClick(View arg0) { 
mSsoHandler = new SsoHandler(Login. this, mWeiboAuth) ; 
mSsoHandler.authorize(new AuthListener() ) ; 


n; 


class AuthListener implements WeiboAuthListener { 


@Override 
public void onComplete(Bundle values) { 
mAccessToken = Oauth2AccessToken. parseAccessToken(values) ; 
if (mAccessToken. isSessionValid()) { 
updateTokenView(false) ; 
AccessTokenKeeper. writeAccessToken(Login. this, 
mAccessToken) ; 


} else { 


@SuppressLint("SimpleDateFormat" ) 
private void updateTokenView(boolean hasExisted) { 
String date = new SimpleDateFormat("yyyy/MM/dd HH:mm:ss") 


. format (new java. util. Date(mAccessToken. getExpiresTime())); 


String format = getString( 
R.string.weibosdk demo token to string format 1); 
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47 String message = String. format(format, mAccessToken. getToken(), 

48 date); 

49 if (hasExisted) { 

50 message = getString(R. string. weibosdk demo token has existed) 
5T + "An" + message; 

52 } 

53 } 

54 

55. f 


其 中 ,24 一 39 行 定义 的 AuthListener 类 是 微 博 认 证 授权 的 回调 类 。SSO 授权 时 ,需要 
在 onActivityResult() 方 法 中 调用 SsoHandler 的 authorizeCallBack() 后 ,该 回调 才 会 被 执 
行 。 当 授权 成 功 后 ,保存 该 access token,expires in, uid 等 信息 到 SharedPreferences 中 。 

© 实现 微 博 主 界面 (如 图 7-13 所 示 )。 微 博 主 界面 主要 是 初始 化 用 户 信息 、 侧 边 菜 单 
以 及 微 博 内 容 区 。 下 面 给 出 内 容 区 域 的 Fragment 实例 FragmentHome 的 核心 代码 : 


° D D u 15:36 


Lu 





详细 28 3 27 v 
资料 ma xit 粉丝 更 多 


‘mim (28) 
5. azul 
Android 课 程 网 站 enna 


zu on 


5. azul 


Android 应 用 与 开发 欢迎 大 家 快 跟 我 一 起 来 学 吧 ! 


图 7-13 微 博 主 界面 


01 public class FragmentHome extends FragmentBase implements 

02 ActionBar. OnNavigationListener { 

03 

04 

05 @Override 

06 public View onCreateView(LayoutInflater inflater, ViewGroup container, 
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07 
08 
09 
10 
TI 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
IDE 
52 
53 
54 
55 


Bundle savedInstanceState) { 
configManager = new ConfigManager(getActivity()); 
if (configManager.getThemeMod() -- 0) 

mRootView = inflater.inflate(R.layout.fragment home, null); 
else { 

mRootView = inflater.inflate(R.layout.fragment home night, null); 
) 
readyHandler. sendEmptyMessageDelayed(0, 2000); 
initActionBar(inflater); 
this.requestRefershImpl = (RequestRefershImpl) getActivity(); 
return mRootView; 


private void initApi() ( 


mAccessToken = AccessTokenKeeper. readAccessToken( mContext) ; 
mStatusesAPI - new StatusesAPI(mAccessToken); 


private void getNewStatues( int featureType) ( 


requestRefershImpl. onRequestRefersh( ) ; 
if (mStatusesAPI == null) { 
initApi(); 
} 
mStatusesAPI. friendsTimel ine( OL, OL, page status count, 1, false, 
featureType, false, mListener); 
new GetAllStatusAsyncTask().execute() ; 
this.current since id - page status count; 


private void updateListData(StatusList statuses) { 


if (statuses != null && statuses. total_number > 0) { 
if (mHomeListAdapter == null) { 
mHomeListAdapter = new HomeListAdapter(this, statuses, 
getActivity()); 
if (swingBottomInAnimationAdapter == null) 
swingBottomInAnimationAdapter = new 
SwingBottomInAnimationAdapter( 
mHomeListAdapter) ; 
swingBottomInAnimationAdapter. setListView(mListView) ; 
if (mListView == null) { 
mListView = (UpDownRefershListView) mRootView 
. findViewById(R. id. 1v_home) ; 
} 
mListView. setAdapter(mHomeListAdapter) ; 
} else { 
mHomeListAdapter. statusList = statuses. statusList; 
mHomeListAdapter. not ifyDataSetChanged() ; 
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56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75) 
76 
Tiri 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
100 
101 
102 
103 
104 


mListView. onPulldownRefreshComplete(); 
requestRefershImpl. onRefershComplete(); 
this.currentList = statuses; 


private RequestListener mListener = new RequestListener() { 
@Override 
public void onComplete(String response) { 
if (!TextUtils.isEmpty(response)) { 
LogUtil. i(TAG, response); 
if (response. startsWith("{\"statuses\"")) ( 
StatusList statuses - StatusList.parse(response); 
if (statuses != null && statuses.total number > 0) ( 
cacheDataToStorge(response, "response. json"); 
updateListData(statuses); 
currentList - statuses; 
} 
} else if (response. startsWith("{\"created_at\"")) { 
Status status = Status. parse( response); 
} else { 
Log. i( TAG, response); 


} 
requestRefershImpl. onRefershComplete( ) ; 


@Override 

public void onWeiboException(WeiboException e) { 
LogUtil.e(TAG, e.getMessage()); 
requestRefershImpl. onRefershComplete( ) ; 
ErrorInfo info = ErrorInfo. parse(e.getMessage()); 
Log. i(TAG, info. toString()); 


h 


private RequestListener mListener all status = new RequestListener() { 
@Override 
public void onComplete(String response) { 
if (!TextUtils.isEmpty(response)) { 
LogUtil. i(TAG, response) ; 
if (response. startsWith("{\"statuses\"")) { 
StatusList statuses = StatusList. parse(response) ; 
if (statuses != null && statuses. total_number > 0) { 
cacheDataToStorge( response, "all response. json"); 
if (configManager. getFeatureType() == 0) 
allList = statuses; 
} 
} else { 
Log. i(TAG, response) ; 
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} 
) 
requestRefershImpl. onRefershComplete( ) ; 
n 


@Override 

public void onWeiboException(WeiboException e) { 
LogUtil. e(TAG, e. getMessage()) ; 
requestRefershImpl. onRefershComplete( ) ; 
ErrorInfo info = ErrorInfo. parse(e. getMessage( )) ; 
Log. i(TAG, info. toString()); 


ji 


其 中 ,25 一 34 行 定 义 的 getNewStatues () 方 法 主要 用 于 下 拉 刷 新 时 获取 最 新 动态 。 
StatusesAPICOauth2AccessTokenaccesssToken) 封 装 了 微 博 的 相关 信息 (详细 API 信息 参 
Jl, http://open. weibo. com/wiki/%E5%BE%AE%E5%8D%9AAPI#.E5. BE. AE. E5. 
8D. 9A) ,提供 的 方法 包括 以 下 几 种 。 


update): 分 享 文字 和 图 片 到 微 博 中 。 

public timelineO : 获取 最 新 的 公共 微 博 。 

friends timelineO ;. 获取 当前 登录 用 户 及 其 所 关注 用 户 的 最 新 微 博 。 
home_timeline(): 获取 当前 登录 用 户 及 其 所 关注 (授权 ) 用 户 的 最 新 微 博 。 
user_timeline(); 获取 用 户 发 布 的 微 博 。 


36—59 行 定义 的 updateListData() 方 法 用 于 刷新 后 更 新 微 博 列表 信息 。61 ~ 89 行 定 
义 的 RequestListener 实例 是 微 博 API 的 回调 接口 ,通过 调用 StatusList. parse(response) 
方法 可 以 解析 出 微 博信 息 。 

除了 上 面 介绍 的 Activity 之 外 ,还 可 以 实现 微 博 撰 写 界面 \ 回 复 界 面 、 用 户 信息 界 面 等 。 


i 


7.3 7] 题 


编程 实现 基于 http://fy. webxml. com. cn/webservices/EnglishChinese. asmx 的 在 


线 翻 译 功能 。 


2. 


编程 实现 基于 百度 云 的 文件 上 传 功能 。 
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Android 框架 通过 提供 丰富 的 网 络 连接 的 API, 来 帮助 构建 丰富 的 基于 云端 的 应 用 ,并 
使 这 些 应 用 可 以 把 数据 同步 到 一 个 远程 服务 器 上 ,同时 确保 多 个 设备 保持 同步 ,并 将 宝贵 数 
据 备份 到 云端 。 


8.1 Google 云 备份 


Google 为 了 给 Android 2. 2 版 本 以 上 的 应 用 程序 的 数据 和 配置 信息 提供 数据 还 原点 ， 
在 Android 的 数据 备份 框架 中 提供 了 把 Android 的 数据 复制 到 远程 云 存储 的 API 接口 。 
这 样 ,在 用 户 恢 复出 厂 设 置 或 者 更 换 新 的 Android 设备 时 ,Google 云 将 对 再 次 安装 的 应 用 
程序 自动 恢复 备份 数据 ,整个 过 程 对 于 用 户 而 言 完全 透明 。Google 云 备 份 完善 了 程序 的 功 
能 ,提高 了 用 户 的 体验 。Android 4.0 以 后 版 本 增加 了 所 有 应 用 (包括 系统 自 带 的 应 用 ) 的 
完全 备份 和 恢复 功能 。 


8.1.1 注册 Android 备份 服务 


只 有 应 用 程序 注册 了 Android 的 备份 服务 , 才 会 被 允许 用 这 个 服务 来 备份 和 恢复 数据 。 
如 果 应 用 程序 想 要 备份 数据 ,那么 为 了 使 用 Android 的 备份 服务 ,就 必须 注册 备份 服务 密 
钥 , 并 把 它 包含 在 应 用 的 Android 清单 文件 中 。 当 Android 的 备份 管理 器 开始 为 应 用 程序 
备份 或 恢复 数据 时 ,Android 备份 服务 的 备份 传输 器 会 检查 清单 文件 中 的 备份 服务 密 钥 ,只 
有 这 个 密 钥 有 效 , 它 才 会 继续 执行 备份 或 恢复 数据 的 操作 。 

注册 备份 服务 密 钥 的 步骤 如 下 : 

(D 登录 https://developer. android. com/google/backup/signup. html? csw — 1.3 rp 
下 方 的 I have read and agree with the Android Backup Service Terms of Service 复 选 框 , 然 
后 在 Application package name 文本 框 中 输入 应 用 的 包 的 名 称 , 再 单 击 Register with 
Android Backup Service 按钮 。 

@ 成 功 注 册 本 服务 后 ,会 收 到 一 个 备份 服务 密 钥 和 对 应 的 <<metardata>> XML 代码 。 
例如 : 


Android Backup Service Key 

Thank you for registering for an Android Backup Service Key! 
Your key is: 
AEdPqrEAAAAI679CqOut5LOOvfH60cqdyWz7TqhvQkkHdXNAng 

This key is good for the app with the package name: 

cn. liwy. project08 


4$ 8z Google -zJRA 





Provide this key in your AndroidManifest. xml file with the following < meta - data > element, 
placed inside the «application? element: 

<meta - data android: name =" com. google. android. backup. api key" android: value = " 
AEdPqrEAAAAIG79CqOutSLOOvfH60cqdyWz7TqhvOkkHdXN4ng" /> 

For more information, see the Backup Dev Guide, or go back to the Android Backup Service 
registration. 


必须 把 这 段 XML 代码 放 在 AndroidManifest. xml HJ < application J6 X F MEX È 
的 子 节点 。 例 如 : 


01 «application android: label = "MyApplication" 


02 android:backupAgent = "MyBackupAgent"> 

03 eS 

04 <meta - data android:name = "com. google. android. backup. api key" 

05 android: value = "AEdPqrEAAAAI679CqOut5LOOv fH60cqdyiWz7 TahvQkkHdXN4ng" 
06 /> 


07 </application> 


其 中 ,android: name 的 值 必须 是 com. google. android. backup. api key. H. android: 
value 必须 是 从 Android 备份 服务 注册 收 到 的 备份 服务 密 钥 。android:backupAgent 的 值 
是 应 用 程序 的 备份 代理 类 。 

当 使 用 Android 备份 服务 的 设备 运行 这 个 应 用 程序 时 ,系统 会 确认 备份 服务 密 钥 的 有 
效 性 。 如 果 有 效 ,Android 备份 服务 会 使 用 设备 上 的 主 Google 账号 把 用 户 的 数据 保存 到 
Google 服务 器 上 。 

注意 : 每 一 个 备份 密 钥 只 在 指定 的 包 名 下 有 效 , 如 果 有 不 同 的 应 用 ,必须 用 各 自 的 包 名 
称 作 为 它们 注册 独立 的 备份 服务 密 钥 。 

由 Android 备份 服务 提供 的 备份 传输 系统 不 保证 所 有 基于 Android 的 设备 都 支持 备份 
功能 。 一 些 设备 可 能 使 用 不 同 的 传输 系统 支持 备份 功能 ,另外 一 些 可 能 根本 不 支持 。 对 于 
应 用 程序 ,没有 一 种 方法 能 够 知道 设备 使 用 的 是 哪 一 种 传输 系统 。 然 而 ,如 果 应 用 实现 了 备 
份 功能 ,那么 总 是 应 当 包 含 一 个 备份 服务 密 钥 的 。 当 设备 使 用 Android 备份 服务 传输 系统 
时 ,这 个 密 钥 用 于 Android 备份 服务 ,使 应 用 程序 能 够 执行 备份 。 如 果 设 备 不 适用 Android 
备份 服务 ,那么 二 meta-data 二 元 素 和 备份 服务 密 钥 会 被 忽略 。 

DNI: 

对 于 保护 用 户 备 份 数 据 的 安全 性 ,Google 有 着 清醒 的 责任 认识 。 为 了 提供 备份 和 恢复 
功能 ,Google 提供 了 安全 的 备份 数据 传输 机 制 。Google 会 按照 它 的 隐私 政策 来 对 待 个 人 信 
息 。 另 外 ,用 户 能 够 通过 Android 系统 的 隐私 设置 来 禁用 数据 备份 功能 。 当 备份 功能 被 禁 
用 时 ,Android 备份 服务 会 删除 所 有 的 被 保存 的 备份 数据 。 用 户 能 够 重新 启用 设备 的 备份 
功能 ,但 Android 的 备份 服务 器 不 会 恢复 之 前 的 任何 被 删除 的 数据 。 


8.1.2 备份 管理 器 


在 数据 备份 的 过 程 中 ,Android 备份 管理 器 (BackupManager) 的 主要 任务 是 查找 应 用 
程序 中 需 备 份 的 数据 ,并 把 数据 交 给 备份 传输 器 ,传输 器 再 把 数据 传送 给 云 存储 。 在 数据 恢 
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复 时 ,备份 管理 器 负责 从 备份 传输 器 取 回 备份 数据 ,并 将 其 返回 给 应 用 程序 ,然后 应 用 程序 
把 数据 恢复 到 设备 上 。 在 恢复 时 ,如果 程序 安装 完毕 且 存 在 用 户 相 关 的 备份 数据 ,Android 
会 自动 执行 恢复 操作 (应 用 程序 也 能 够 调用 BackupManager 的 requestRestore() 方 法 发 起 
恢复 请 求 ) 。 

1. 主要 方法 

BackupManager 提供 的 主要 方法 包括 以 下 几 种 。 

(1) dataChanged() 和 dataChanged(String packageName) 

为 了 获取 一 个 备份 , 只 需要 创建 一 个 BackupManager 的 实例 ,然后 调用 它 的 
dataChanged() 方 法 。 例 如 : 


01 public void requestBackup() { 

02 BackupManager bm = new BackupManager( this); 
03 bm. dataChanged( ) ; 

04 ) 


应 用 数据 备份 请 求 通 过 调用 BackupManager Xf & ff]. dataChanged () 方 法 发 出 。 
dataChanged() 方 法 先 调用 checkServiceBinder() 方 法 (BackupManager 对 象 在 发 出 发 出 备 
份 和 恢复 的 请 求 之 前 需要 先 调 用 checkServiceBinder ( ) 方 法 实例 化 一 个 
BackupManagerService 服务 的 客户 端 代理 对 象 ,通过 该 对 象 向 BackupManagerService 服务 
发 出 备份 或 恢复 请 求 。) 获 得 BackupManagerService 服务 客户 端 代理 对 象 后 ,接着 调用 服务 
端的 dataChanged() 同 名 方法 发 出 备份 请 求 。 

(2) requestRestore(RestoreObserver observer) 

应 用 数据 恢复 请 求 通常 由 系统 在 应 用 安装 时 发 现 有 要 恢复 的 数据 时 自动 触发 ， 
PackageManagerService 在 应 用 安装 成 功 后 ,如 果 发 现 新 安装 的 工程 文件 包含 backupAgent 
属性 时 自动 触发 。 

当然 用 户 也 可 以 调用 BackupManager 对 象 的 requestRestore() 方 法 来 发 出 一 个 恢复 请 求 。 
requestRestore( ) 方 法 同样 先 调用 checkServiceBinder( ) 方 法 获得 BackupManagerService 
服务 的 一 个 客户 端 代理 对 象 ,然后 调用 服务 端的 beginRestoreSession() 方 法 实例 化 一 个 
ActiveRestoreSession 对 象 ,返回 客户 端 一 个 IrestoreSession 接口 对 象 , 并 根据 
IrestoreSession 接口 实例 化 一 个 客户 端 RestoreSession 对 象 ,通过 RestoreSession 对 象 使 用 
IrestoreSession 接口 向 服务 端的 ActiveRestoreSession 对 象 的 方法 发 送 恢复 请 求 。 

并 不 是 所 有 Android 平台 的 设备 都 能 支持 数据 备份 。 不 过 ,就 算是 在 不 支持 备份 传输 
的 设备 上 ,程序 仍然 会 正常 运行 ,只 是 不 能 接收 备份 管理 器 的 请 求 进行 数据 备份 而 已 。 

注意 : 备份 服务 并 不 是 设计 用 于 与 其 他 客户 端 同步 应 用 程序 数据 ,或 者 用 于 在 通常 的 
应 用 程序 生命 周期 中 保存 想 访问 的 数据 。 不 能 够 请 求 读 、 写 备份 数据 ,也 不 能 够 通过 除 备份 
管理 器 的 API 以 外 的 方式 访问 备份 数据 。 在 备份 过 程 中 ,只 有 备份 管理 器 和 备份 传输 器 有 
权限 访问 被 提交 的 数据 。 

2. 备份 传输 器 

备份 传输 器 是 Android 备份 框架 的 客户 端 组 件 , 它 可 由 设备 制造 商 和 提供 商定 制 。 备 
份 传输 器 可 以 因 设 备 不 同 而 不 同 ,对 于 应 用 程序 而 言 它 是 透明 的 。 备 份 管理 器 的 API 将 应 
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用 程序 和 实际 备份 传输 器 连接 起 来 ,通过 一 组 固定 的 API 与 备份 管理 器 进行 通信 ,而 不 必 
关心 底层 的 传输 过 程 。 

3. 检查 数据 版 本 

在 把 数据 保存 到 云 存 储 中 时 ,备份 管理 器 会 自动 包含 应 用 程序 的 版 本 号 ,版 本 号 是 在 
AndroidManifest. xml 文件 的 android: versionCode 属性 中 定义 的 。 在 调用 备份 代理 恢复 数 
据 之 前 ,备份 管理 器 会 查询 已 安装 程序 的 android: versionCode, 并 与 记录 在 备份 数据 中 的 
版 本 号 相 比 较 。 如 果 备 份 数据 的 版 本 比 设备 上 的 要 新 , 则 意味 着 用 户 安装 了 旧版 本 的 程序 。 
这 时 备份 管理 器 将 停止 恢复 操作 ,onRestore() 方 法 也 不 会 被 调用 。 

用 android:restoreAnyVersion 属性 可 以 取代 以 上 规则 。 此 属性 用 true 或 false 标明 是 
否 在 恢复 时 忽略 数据 集 的 版 本 ,默认 值 是 false。 如 果 将 其 设 为 true, 备 份 管 理 器 将 忽略 
android: versionCode 并 且 每 次 都 会 调用 onRestore() 方 法 。 这 时 候 可 以 在 onRestore() 里 
人 工 检查 版 本 ,并 在 版 本 冲突 时 采取 必要 的 措施 保证 数据 的 兼容 性 。 

为 了 便于 在 恢复 数据 时 对 版 本 号 进行 判断 处 理 ,onRestore() 把 备份 数据 的 版 本 号 作为 
appVersionCode 参数 和 数据 一 起 传人 方法 。 而 用 PackageInfo. versionCode 可 以 查询 当前 
应 用 程序 的 版 本 号 ,例如 : 


01 PackageInfo info; 

02 try { 

03 String name = getPackageName( ) ; 

04 info = getPackageManager( ). getPackageInfo( name, 0) ; 
05 } catch (NameNotFoundException nnfe) { 

06 info = null; 

07 ) 


09 int version; 

10 if (info != null) { 

nk version = info. versionCode; 
12 


然后 ,简单 比较 一 下 PackageInfo 中 的 version 和 传人 onRestoreO ff] appVersionCode 
即 可 。 


8.1.3 BackupAgent 备份 代理 


为 了 备份 应 用 程序 数据 ,需要 实现 一 个 备份 代理 。 此 备份 代理 将 被 备份 管理 器 调用 ,用 
于 提供 所 需 备 份 的 数据 。 当 程序 重 装 时 ,还 要 调用 此 代理 来 恢复 数据 。 备 份 管理 器 处 理 所 
有 与 云 存 储 之 间 的 数据 传输 工作 ,备份 代理 则 负责 所 有 对 设备 上 数据 的 处 理 。 

BackupAgent 是 Android 提供 的 两 种 备份 代理 方式 之 一 。BackupAgent 类 提供 了 核心 接 
口 ,程序 通过 这 些 接口 与 备份 管理 器 进行 通信 。 如 果 直 接 继承 此 类 ,必须 重 载 onBackupO 
和 onRestore() 方 法 来 处 理 数据 的 备份 和 恢复 操作 。 

大 多 数 应 用 程序 应 该 不 需要 直接 继承 使 用 BackupAgent 类 ,取而代之 的 是 继承 
BackupAgentHelper 类 ,并 利用 BackupAgentHelper 内 建 的 helper 类 自动 备份 和 恢复 文 
件 。 不 过 ,如 果 需 要 实现 以 下 目标 ,可 以 直接 继承 BackupAgent: 
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。 将 数据 格式 版 本 化 。 例 如 需要 在 恢复 数据 时 修正 格式 ,可 以 建立 一 个 备份 代理 ,在 
数据 恢复 过 程 中 如 果 发 现 当 前 版 本 和 备份 时 的 版 本 不 一 致 ,可 以 执行 必要 的 兼容 性 
修正 工作 。 

* 不 是 备份 整个 文件 ,而 是 指定 应 当 被 复制 的 那 一 部 分 数据 以 及 每 一 部 分 之 后 如 何 还 
原 到 设备 上 。 这 也 有 助 于 管理 不 同 版 本 的 数据 ,因为 是 把 数据 作为 唯一 Entity 来 读 
写 ,而 不 是 读 写 整个 文件 。 

。 备份 数据 库 中 的 数据 。 如 果 用 到 SQLite 数据 库 并 且 希 望 用 户 重 装 系统 时 能 恢复 其 
中 数据 ,需要 建立 自 定义 的 BackupAgent。 它 在 备份 时 读 取 库 中 数据 ,而 在 恢复 时 


建 表 并 插入 数据 。 
通过 继承 BackupAgent 创建 备份 代理 时 ,必须 实现 以 下 回调 方法 。 
1. onBackup() 


备份 管理 器 在 程序 请 求 备份 后 将 调用 本 方法 。 在 本 方法 中 实现 从 设备 读 取 应 用 程序 数 
据 , 并 把 需 备份 的 数据 传递 给 备份 管理 器 。 

应 用 程序 可 以 在 任意 时 间 调 用 dataChanged() 请 求 备份 操作 。 这 个 方法 提醒 备份 管理 
器 ,需要 使 用 备份 代理 执行 备份 数据 。 接 着 ,备份 管理 器 会 在 某 个 合适 的 时 刻 回调 备份 代理 
的 onBackup() 方 法 (注意 ,一 次 备份 请 求 并 不 会 在 onBackup() 方 法 调用 时 立即 返回 结果 ) 。 
一 般 来 说 ,应 当 在 每 一 次 数据 改变 时 请 求 一 次 备份 (例如 当 用 户 更 改 了 应 用 程序 配置 时 ) 。 
如 果 在 备份 管理 器 从 代理 请 求 备份 之 前 ,连续 调用 dataChanged O ,代理 依旧 只 调用 一 次 
onBackup() 。 

当 备 份 管理 器 调用 onBackup() 方 法 时 , 它 会 传递 以 下 三 个 参数 。 

(1) oldState 

一 个 公开 的 、 只 读 的 ParcelFileDescriptor 对 象 ,指向 由 应 用 提供 的 上 一 次 备份 状态 。 这 不 
是 来 自 云 储存 的 备份 数据 ,而 是 本 地 数据 的 一 个 标记 ,是 在 上 一 次 调用 onBackup() 时 备份 的 
(由 下 面 的 newState 定义 ,或 者 来 自 onRestore()) 。 由 于 onBackup() 不 允许 读 取 云 储存 上 已 有 
的 备份 数据 ,可 以 使 用 这 个 本 地 的 标记 来 判断 从 上 次 备份 以 来 数据 是 否 发 生 改 变 。 

(2) data 

—^r BackupDataOutput 对 象 ,用 于 传递 备份 数据 到 备份 管理 器 。 

(3) newState 

一 个 公开 的 、 可 读 可 写 的 ParcelFileDescriptor 对 象 , 指 向 一 个 文件 。 在 这 个 文件 中 , 必 
须 写 人 一 个 传递 数据 的 标记 (一 个 标记 可 以 简单 地 使 用 文件 最 后 一 次 修改 的 时 间 惟 )。 在 下 
一 次 备份 管理 器 调用 onBackup() 方 法 时 ,这 个 对 象 会 被 当 作 oldState 返回 。 如 果 没 有 向 
newState 中 写 和 人 备份 数据 ,那么 下 一 次 备份 管理 器 调用 onBackup() 时 ,oldState 将 会 指向 
一 个 空 文件 。 

下 面 的 代码 是 使 用 BackupAgent 实现 备份 代理 时 实现 数据 备份 的 示例 ,onBackup() 方 
法 的 代码 如 下 : 





01 @Override 

02 public void onBackup(ParcelFileDescriptor oldState, BackupDataOutput data, 
03 ParcelFileDescriptor newState) throws IOException { 

04 
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05 
06 
07 
08 
09 
10 
I 
12 
3 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 


synchronized (BackupRestoreActivity.sDataLock) { 


RandomAccessFile file - new RandomAccessFile(mDataFile, "r"); 


mFilling - file.readInt(); 
mAddMayo = file.readBoolean(); 
mAddTomato - file.readBoolean(); 


boolean doBackup = (oldState == null); 
if (!doBackup) { 
doBackup = compareStateFile(oldState) ; 


if (doBackup) { 


ByteArrayOutputStream bufStream = new ByteArrayOutputStream(); 


DataOutputStream outWriter = new DataOutputStream(bufStream); 


outWriter. writeInt(mFilling); 
outWriter. writeBoolean(mAddMayo); 
outWriter. writeBoolean(mAddTomato) ; 


byte[] buffer = bufStream. toByteArray(); 
int len = buffer. length; 
data.writeEntityHeader(APP DATA KEY, len); 
data.writeEntityData(buffer, len); 


writeStateFile(newState); 


05~10 行 通过 synchronized 实现 用 同一 个 内 部 锁 的 同步 备份 和 恢复 操作 。12 一 15 fF 
调用 compareStateFile() 方 法 比较 oldState, 检 查 自 上 次 备份 以 来 数据 是 否 发 生 改 变 。 从 
oldState 读 取 信息 的 方式 取决 于 当时 写 人 的 方式 。 最 简单 的 记录 文件 状态 的 方式 是 写 人 文 
件 的 最 后 修改 时 间 戳 ,compareStateFile() 方 法 的 代码 如 下 : 


01 boolean compareStateFile(ParcelFileDescriptor oldState) { 


02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 


FileInputStream instream - new FileInputStream( 
oldState.getFileDescriptor()); 
DataInputStream in = new DataInputStream( instream) ; 


try { 
int stateVersion = in. readInt(); 
if (stateVersion > AGENT_VERSION) { 
return true; 


int lastFilling = in. readInt(); 
boolean lastMayo = in. readBoolean() ; 
boolean lastTomato = in. readBoolean(); 
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15 

16 return (lastFilling != mFilling) 

17 || (lastTomato != mAddTomato) 
18 || (1astMayo != mAddMayo); 
19 } catch (IOException e) { 

20 return true; 

21 } 

2228 


02 行 通过 FileInputStream 获取 oldState 输入 流 ,07 行 从 state 文件 获取 最 后 的 修改 时 
Te] BX « 

onBackup() 方 法 的 17~29 行 是 在 与 oldState 比较 后 ,如 果 数 据 发 生 了 变化 , 则 把 当前 
数据 写 人 data, 以 便 将 其 返回 并 上 传 到 云 存储 中 。 

必须 以 BackupDataOutput 中 的 entity 方式 写 入 每 一 块 数据 (程序 负责 把 数据 切 分 为 
多 个 entity, 当然 也 可 以 只 用 一 个 entity) 。 一 个 entity 是 用 一 个 唯一 字符 串 键 值 标识 的 拼 
接 二 进 制 数据 记录 。 因 此 ,所 备份 的 数据 集 其 实 是 一 组 键 值 对 。 要 在 备份 数据 集中 增加 一 
个 entity, 必 须 调用 writeEntityHeader() ,传人 代表 写 人 数据 的 唯一 字符 串 键 值 和 数据 大 
小 。 同 时 调用 writeEntityData() ,传人 存放 数据 的 字 节 类 型 缓冲 区 ,以 及 需 从 缓冲 区 写 人 
的 字 节 数 ( 必 须 与 传 给 writeEntityHeader() 的 数据 大 小 一 致 ) 。 

无 论 是 否 执行 备份 , 都 要 把 当前 数据 的 状态 信息 写 入 ParcelFileDescriptor 对 象 
newState 指向 的 文件 内 。 备 份 管理 器 会 在 本 地 保持 此 对 象 ,以 代表 当前 备份 的 数据 。 下 次 
调用 onBackup() 时 ,此 对 象 作为 oldState 返回 给 应 用 程序 ,由 此 可 以 决定 是 否 需 要 再 做 一 
次 备份 。 如 果 不 把 当前 数据 的 状态 写 入 此 文件 ,下 次 调用 时 oldState 将 返回 空 值 。 负 责 写 
状态 信息 的 writeStateFile() 方 法 代码 如 下 : 





01 void writeStateFile(ParcelFileDescriptor stateFile) throws IOException { 


02 FileOutputStream outstream - new FileOutputStream( 

03 stateFile.getFileDescriptor()); 

04 DataOutputStream out = new DataOutputStream(outstream); 
05 


06 out.writeInt(AGENT VERSION); 
07 out.writeInt(mFilling); 

08 out. writeBoolean( mAddMayo); 
09 out. writeBoolean(mAddTomato) ; 
10} 


以 下 代码 实现 把 文件 最 后 修改 时 间 戳 作为 当前 数据 的 状态 存 人 newState: 


01 FileOutputStream outstream = new FileOutputStream( 

02 newState.getFileDescriptor()); 

03 DataOutputStream out = new DataOutputStream(outstream); 
04 long modified = mDataFile. lastModified(); 

05 out. writeLong( modified) ; 
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2. onRestore() 

备份 管理 器 在 恢复 数据 时 调用 本 方法 (也 可 以 主动 请 求 恢 复 , 但 在 用 户 重 装 应 用 程序 时 
系统 会 自动 执行 数据 恢复 。) ,备份 管理 器 调用 本 方法 时 将 传人 备份 的 数据 ,然后 就 可 把 数据 
恢复 到 设备 上 。 

在 应 用 程序 正常 的 生命 周期 中 ,一 般 不 需要 请 求 还 原 。 在 应 用 程序 安装 时 ,系统 会 自动 
检查 备份 数据 并 执行 还 原 。 然 而 ,如 果 有 必要 ,可 以 调用 requestRestore() 方 法 手动 请 求 还 
原 。 在 这 种 情况 下 ,备份 管理 器 调用 onRestore() 方 法 实现 ,同时 传递 来 自 当 前 备份 数据 集 
的 数据 。 

只 用 备份 管理 器 能 够 调用 onRestore()。 这 发 生 在 系统 安装 应 用 并 发 现 已 存在 的 备份 
数据 的 时 候 。 然 后 ,可 以 通过 调用 requestRestore() 请 求 还 原 操作 。 当 备份 管理 器 调用 
onRestore() 方 法 时 , 它 传递 以 下 三 个 参数 。 

(1) data。 

一 个 BackupDataInput 对 象 , 它 允 许 读 取 备份 数据 。 

(2) appVersionCode, 

一 个 整数 ,标记 应 用 程序 的 android: versionCode 清单 的 属性 值 , 这 个 值 是 当前 数据 备 
份 的 时 间 。 可 以 使 用 这 个 值 来 再 次 确认 当前 应 用 程序 的 版 本 ,并 判断 数据 格式 是 否 兼容 。 

(3) newState, 

一 个 公开 的 、 可 读 可 写 的 ParcelFileDescriptor 对 象 ,指向 一 个 文件 。 在 这 个 文件 中 , 必 
须 写 人 数据 提供 的 最 终 备 份 状 态 。 当 下 一 次 onBackup() 被 调用 ,这 个 对 象 会 作为 oldState 
被 返回 。 重 复 调用 ,必须 写 人 同样 的 newState 在 onBackup() 的 回调 中 。 同 时 ,这 样 可 以 确 
保 传 给 onBackupO fff oldState 对 象 是 合法 的 ,即使 是 在 设备 恢复 后 第 一 次 调用 onBackup() 。 

下 面 的 代码 是 使 用 BackupAgent 实现 备份 代理 时 实现 数据 恢复 的 示例 ,onRestore() 方 
法 的 代码 如 下 : 


01 @Override 
02 public void onRestore(BackupDataInput data, int appVersionCode, 


03 ParcelFileDescriptor newState) throws IOException { 

04 while (data. readNextHeader()) ( 

05 String key = data.getKey(); 

06 int dataSize - data.getDataSize(); 

07 

08 if (APP DATA KEY.equals(key)) { 

09 byte[] dataBuf = new byte[dataSize]; 

10 data.readEntityData(dataBuf, 0, dataSize); 

mr: ByteArrayInputStream baStream = new ByteArrayInputStream( 
12 dataBuf); 

13 DataInputStream in = new DataInputStrean(baStream); 

14 

15 mFilling - in.readInt(); 

16 mAddMayo = in.readBoolean(); 

17 mAddTomato = in.readBoolean(); 

18 

19 synchronized (BackupRestoreActivity.sDataLock) { 

20 RandomAccessFile file - new RandomAccessFile(mDataFile, "rw"); 
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21 file. setLength(OL); 

22 file.writeInt(mFilling); 

23 file.writeBoolean(mAddMayo); 
24 file. writeBoolean(mAddTomato) ; 
25 } 

26 } else { 

27 data. skipEntityData(); 

28 } 

29 } 

30 

ot writeStateF ile(newState) ; 

32 ] 


在 onRestore() 实 现 中 ,应 当 像 04 行 那样 对 data 调用 readNextHeader() 方 法 ,以 遍历 
数据 集 里 所 有 的 entity。 对 其 中 每 个 entity 需 进 行 以 下 操作 : 

(1) 调用 getKey() 获 取 entity 的 键 值 (如 05 行 ) 。 

(2) 将 此 entity 键 值 和 已 知 键 值 清单 进行 比较 (如 08 行 ), 这 个 清单 应 该 已 经 在 
BackupAgent 继承 类 中 作为 字符 串 常 量 (static final string) 进 行 定义 。 一 旦 键 值 匹配 其 中 
一 个 键 ,就 执行 读 取 entity 数据 并 保存 到 设备 的 语句 。 

® 调用 getDataSize() 读 取 entity 数据 的 大 小 并 由 此 创建 字 节 数组 (如 06、09 £3) 。 

© 调用 readEntityData() ,传人 字 节 数组 作为 获取 数据 的 缓冲 区 ,并 指定 起 始 位 置 和 读 
取 字 节 数 ( 如 10 行 ) 。 

@ 字 节 数组 将 被 十 人 数据 , 按 需 读 取 数 据 并 写 和 人 设备 即 可 。 

(3) 把 数据 读 出 并 写 回 设备 以 后 ,与 上 面 备 份 数 据 的 onBackup () 过 程 类 似 , 调 用 
writeStateFile() 方 法 把 数据 的 状态 写 人 newState 参数 。 


8.1.4 BackupAgentHelper 备份 代理 


如 果 要 备份 整个 文件 (来 自 SharedPreferences 或 内 部 存储 ) ,应 该 用 BackupAgentHelper 
创建 备份 代理 来 实现 。BackupAgentHelper 类 提供 了 BackupAgent 类 的 易 用 性 封装 , 它 减 
少 了 需 编写 的 代码 数量 (不 必 实 现 onBackup() 和 onRestoreO) 。 

BackupAgentHelper 的 实现 必须 要 使 用 一 个 或 多 个 Backup 助手 。Backup 助手 是 一 种 
专用 组 件 ,BackupAgentHelper 用 它 来 对 特定 类 型 的 数据 执行 备份 和 恢复 操作 。Android 
框架 目前 提供 两 种 Backup 助手 。 

。 SharedPreferencesBackupHelper: 用 于 备份 SharedPreferences 文件 。 
* FileBackupHelper: 用 于 备份 来 自 内 部 存储 的 文件 。 

BackupAgentHelper 可 包含 多 个 Backup 助手 ,但 对 于 每 种 数据 类 型 只 需 用 到 一 个 
Backup 助手 。 也 就 是 说 ,即使 存在 多 个 SharedPreferences 文件 ,也 只 需要 一 个 
SharedPreferencesBackupHelper。 

对 于 每 个 要 加 入 BackupAgentHelper 的 Backup 助手 ,必须 在 onCreate() 中 执行 以 下 
步骤 : 

(D 实例 化 所 需 的 Backup 助手 。 在 其 构造 方法 里 必须 指定 需 备份 的 文件 。 
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© 调用 addHelper()。 把 Backup 助手 加 入 BackupAgentHelper。 
例如 : 


01 @Override 
02 public void onCreate() { 
03 FileBackupHelper helper = new FileBackupHelper(this, 


04 TOP SCORES, PLAYER STATS); 
05 addHelper(FILE HELPER KEY, helper); 
06 ] 


1. SharedPreferencesBackupHelper 

SharedPreferencesBackupHelper 类 包含 了 所 有 用 于 备份 和 还 原 一 个 SharedPreferences X 
件 的 代码 。 当 备份 管理 器 调用 onBackup() 和 onRestore() 时 ,BackupAgentHelper 调用 备 
份 助手 来 执行 指定 文件 的 备份 和 还 原 。 

备份 配置 信息 时 ,首先 创建 一 个 SaredPreferencesBackupHelper。 例 如 : 


01 public class BlundellBackupAgent extends BackupAgentHelper { 
02 

03 @Overr ide 

04 public void onCreate() { 


05 super. onCreate() ; 

06 SharedPreferencesBackupHelper helper - new 

07 SharedPreferencesBackupHelper( 

08 this, 

09 PreferenceConstants. TUTORIAL PREFERENCES); 
10 addHelper(PreferenceConstants. HELPER KEY, helper); 

11 } 

pe 


然后 在 Activity 的 onCreate O 生命 周期 方法 中 实例 化 SharedPreferences Xj & Ail 
BackupManager 实例 。 例 如 : 


01 @Override 

02 public void onCreate(Bundle savedInstanceState) { 

03 super. onCreate(savedInstanceState); 

04 setContentView(R. layout.activity backup agent helper); 
05 aes 

06 //Setup your shared preferences 

07 SharedPreferences sharedPreferences = getSharedPreferences( 
08 PreferenceConstants. TUTORIAL PREFERENCES, 

09 MODE PRIVATE); 

10 BackupManager backupManager = new BackupManager(this); 
11 CloudBackedSharedPreferences preferences - new 


12 CloudBackedSharedPreferences( sharedPreferences, 
13 backupManager) ; 
14 ] 
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最 后 ,在 AndroidManifest. xml fff] application? fg 4& AW fj android: backupAgent 属性 
声明 备份 代理 。 例 如 : 


01 «application android: label = "@string/app_name" 

02 android: backupAgent = ". backupagent. BlundellBackupAgent"» 

03 ceo 

04 <meta- data android:name = "con. google. android. backup. api. key" 

05 android:value- "AEdPqrEAAAAI679CqOut5LOOv£H60cqdyflz7 TqhvOkkHdXN4ng" /> 


06 «activity ... > 
07 E 
08 </activity > 


09 </application> 


注意 : SharedPreferences 是 线程 安全 的 ,所 以 可 以 从 备份 代理 和 其 他 Activity 安全 地 
读 写 共 享 配 置 文件 。 

2. FileBackupHelper 

FileBackupHelper 用 于 备份 一 个 文件 。 在 实例 化 FileBackupHelper 时 ,必须 包含 一 个 
或 多 个 保存 于 程序 内 部 存储 中 的 文件 名 称 。 下 面 是 一 个 FileBackupHelper 的 示例 : 


01 public class FileHelperExampleAgent extends BackupAgentHelper { 
02 static final String FILE HELPER KEY - "the file"; 

03 

04 @Override 

05 public void onCreate() { 


06 FileBackupHelper helper = new FileBackupHelper(this, 
07 BackupAgentActivity.DATA FILE NAME); 

08 addHelper(FILE HELPER KEY, helper); 

09 } 

10 


E @Override 
12 public void onBackup(ParcelFileDescriptor oldState, 


13 BackupDataOutput data, 

14 ParcelFileDescriptor newState) throws IOException { 
15 synchronized (BackupAgentActivity. sDataLock) { 

16 super. onBackup(oldState, data, newState) ; 

17 } 

18 } 

19 


20 @Override 
21 public void onRestore(BackupDataInput data, int appVersionCode, 


22 ParcelFileDescriptor newState) throws IOException { 
23 synchronized (BackupAgentActivity. sDataLock) { 

24 super. onRestore(data, appVersionCode, newState) ; 
25 } 

26 } 

Ars 


这 个 FileHelperExampleAgent 类 包含 所 有 必要 的 代码 ,以 备份 和 还 原 保存 到 应 用 的 内 
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部 存储 文件 。 然 而 ,在 内 部 存储 中 读 取 和 写 入 文件 并 不 是 线程 安全 的 。 为 确保 备份 代理 
不 在 一 个 时 间 读 取 或 写 入 文件 ,必须 在 每 一 次 执行 读 或 者 写 操作 时 使 用 同步 的 状态 。 例 
如 ,在 任何 的 Activity 内 读 取 或 写 入 文件 时 ,需要 使 用 一 个 对 象 为 同步 状态 提供 一 个 固有 
的 锁 : 


01 //Object for intrinsic lock 
02 static final Object sDataLock = new Object(); 


然后 在 每 一 次 读 取 或 写 入 文件 时 ,使 用 这 个 锁 创建 一 个 同步 的 状态 。 例 如 ,下 面 的 同步 
状态 用 于 将 游戏 中 的 最 后 一 次 得 分 写 入 一 个 文件 中 : 


01 try{ 

02 synchronized (MyActivity. sDataLock) ( 

03 File dataFile = new File(getFilesDir(), TOP SCORES); 

04 RandomAccessFile raFile = new RandomAccessFile(dataFile, "rw"); 
05 raFile. writeInt(score) ; 

06 } 


07 } catch (IOException e) { 
08 Log. e(TAG, "Unable to write to file"); 
09 } 


应 当 使 用 同一 个 锁 同 步 读 取 状 态 ,接着 在 BackupAgentHelper 类 中 必须 重 写 onBackup() 
和 onRestore € ) 方 法 ,使 用 同一 个 固有 的 锁 同步 备份 和 还 原 操 作 。 例 如 , 上面 
FileHelperExampleAgent 这 个 例子 需要 以 下 方法 : 


01 @Override 

02 public void onBackup(ParcelFileDescriptor oldState, BackupDataOutput data, 
03 ParcelFileDescriptor newState) throws IOException { 

04 / /Hold the lock while the FileBackupHelper performs backup 

05 synchronized (MyActivity. sDataLock) { 

06 super. onBackup(oldState, data, newState); 

07 } 

08 } 


10 @Override 

11 public void onRestore(BackupDataInput data, int appVersionCode, 
12 ParcelFileDescriptor newState) throws IOException { 

13 / /Hold the lock while the FileBackupHelper restores the file 
14 synchronized (MyActivity. sDataLock) ( 

15 super. onRestore(data, appVersionCode, newState); 

16 } 


这 样 , 就 可 以 添加 FileBackup Helper XJ 2 8] onCreate() 方 法 中 ,并 重 写 onBackup() 和 
onRestore() 方 法 以 同步 读 写 操作 。 
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8.1.5 测试 备份 代理 


实现 了 备份 代理 之 后 ,可 以 使 用 bmgr 命令 工具 测试 备份 和 还 原 功能 。 

bmgr 是 一 个 Shell 工具 ,用 来 支持 Android 8 或 更 高 版 本 API 接口 的 Android 设备 的 
备份 管理 器 进行 交互 。 它 提供 了 包括 备份 和 恢复 操作 的 命令 ,这 样 就 不 必 反 复 擦 除数 据 或 采 
取 类 似 的 侵入 性 步骤 来 测试 应 用 程序 的 备份 代理 功能 了 。 这 些 命令 均 可 在 adb shell 上 运行 。 

1. 启动 /禁用 备份 

通过 bmgr enabled 命令 ,可 以 看 到 备份 管理 器 当前 是 否 可 以 操作 ,例如 : 


adb shell bmgr enable < boolean 


<boolean>#é true zk false。 这 相当 于 在 设备 的 主 设置 用 户 界面 禁用 或 启用 备份 操作 。 

如 果 应 用 程序 的 备份 代理 从 未 被 调用 进行 备份 ,那么 验证 操作 系统 认为 它 是 否 应 该 执 
行 这 样 的 操作 ,可 能 要 用 到 这 个 命令 。 

注意 : 当 备 份 功能 被 禁用 了 ,当前 的 备份 系统 将 会 从 备份 存储 里 擦 除 整 个 有 效 的 数据 
集 。 这 就 是 说 , 当 一 个 用 户 不 希望 他 的 数据 被 备份 ,备份 管理 器 将 不 再 备份 。 数 据 将 不 会 被 
保存 在 设备 中 ,也 不 可 能 有 恢复 操作 ,除非 重新 启用 备份 管理 器 。 

2. 强制 备份 操作 

通常 , 当 应 用 程序 的 数据 发 生 了 变化 ,通过 调用 dataChanged ) 方 法 来 通知 备份 管理 
器 。 然 后 备份 管理 器 将 调用 备份 代理 的 onBackup() 接 口 。 然 而 ,可 以 通过 运行 bmgr 命令 
来 调用 备份 请 求 , 例 如 : 


adb shell bmgr backup <package> 


去 package> 是 计划 进行 备份 的 应 用 程序 的 正式 包 名 。 当 执行 了 此 备份 命令 ,应 用 程序 
的 备份 代理 将 在 未 来 一 段 时 间 内 被 调用 来 执行 备份 操作 。 虽 然 不 能 保证 会 备份 ,但 是 借助 
bmgr 运行 命令 , 仍 可 以 强制 所 有 还 未 进行 的 备份 立即 运行 ,例如 : 


adb shell bmgr run 


立即 执行 的 备份 操作 ,包括 自 上 次 备份 操作 后 调用 dataChanged() 的 所 有 应 用 程序 和 
通过 bmgr backup 手动 计划 备份 的 任何 应 用 程序 。 

3. 强制 还 原 操作 

与 集中 在 一 起 、 间 或 运行 的 备份 操作 不 同 ,还 原 操作 是 立即 执行 的 。 备 份 管理 器 当前 提 
供 了 两 种 类 型 的 恢复 操作 。 第 一 种 是 从 从 已 备份 的 数据 中 恢复 整个 设备 的 数据 。 这 通常 是 
一 个 设备 首次 配置 (复制 用 户 先前 设备 的 设置 和 其 他 保存 的 状态 ) ,并 且 仅 由 系统 的 操作 执 
行 。 第 二 种 还 原 操作 是 恢复 单一 的 应 用 程序 到 “活动 ”的 数据 设置 , 即 应 用 程序 将 舍弃 当前 
的 数据 ,从 当前 备份 映像 的 最 后 一 个 运行 良好 的 数据 备份 恢复 。 可 以 通过 requestRestoreO 77 
法 调用 第 二 个 还 原 操作 。 备 份 管理 器 将 调用 备份 代理 的 OnRestore() 接 口 。 

在 测试 应 用 程序 时 ,通过 使 用 bmgr 的 恢复 命令 ,可 以 立即 调用 应 用 程序 的 还 原 操作 ， 
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例如 : 


adb shell bmgr restore <package> 


二 package 二 是 想 恢 复 的 应 用 程序 的 正式 包 名 ,前 提 是 这 个 应 用 程序 已 进行 过 备份 、 恢 
复 操作 。 备 份 管理 器 将 立即 检查 应 用 程序 的 备份 代理 ,并 调用 它 进行 还 原 。 即 使 应 用 程序 
当前 没有 运行 ,也 可 以 进行 。 

4. 擦 除数 据 

单个 应 用 程序 的 数据 可 以 从 当前 的 数据 集中 擦 除 。 当 正在 开发 一 个 备份 代理 ,如 果 错 
误导 致 写 下 无 效 的 数据 或 保存 状态 信息 ,这 个 命令 是 非常 有 用 的 。 可 以 用 bmgr 擦 除 命令 
来 擦 除 应 用 程序 的 数据 ,例如 : 


adb shell bmgr wipe < package > 


去 package 盖 是 要 删除 数据 的 应 用 程序 的 正式 包 名。 应 用 程序 代理 进程 的 下 一 次 备份 
操作 使 这 个 应 用 程序 看 起 来 似乎 之 前 从 未 备份 过 。 


8.2 Google 云 信 息 


Google 云 信息 (Google Cloud Messaging for Android,GCM) 是 一 个 能 够 帮助 开发 者 从 
服务 端 发 送 数 据 到 运行 在 Android 手机 程序 的 免费 服务 。 这 个 服务 提供 了 一 个 简单 、 轻 量 
级 的 机 制 ,使 得 服务 端 可 以 告诉 移动 端的 程序 与 服务 端 建立 直接 的 联系 ,来 获取 更 新 的 程序 
或 者 用 户 的 数据 。 


8.2.1 GCM 框架 


GCM 是 云 到 端 消息 框架 (C2DM) 的 改进 ,实现 了 服务 无 配额 限制 、 无 须 注册 ,并 提供 了 
一 套 更 丰富 的 全 新 接口 。Google GCM 服务 器 维护 客户 端 和 服务 端 之 间 的 通信 ,负责 处 理 
消息 队列 和 分 发 至 运行 在 Android 设备 上 的 目标 应 用 的 各 个 方面 。GCM 服务 如 今 已 成 为 
Google 其 他 众多 接口 的 一 部 分 ,并 由 一 个 基于 Google API 控制 台 的 项 目 所 管理 。 与 
Google 其 他 接口 不 同 ,GCM 服务 没有 配额 限制 ,所 以 无 论 有 多 少 消 息 、 多 少 设备 使 用 这 项 
服务 ,都 是 完全 免费 的 。 
1. 主要 特点 
GCM 服务 的 主要 特点 包括 : 
。 允许 第 三 方 应 用 服务 器 发 送 消息 到 Android 应 用 。 
。 不 能 保证 消息 的 发 送 和 消息 的 顺序 。 
。 不 需要 Android 设备 上 的 应 用 一 直 运 行 ,在 收 到 消息 时 , 只 要 在 应 用 的 
AndroidManifest. xml 中 设置 了 适当 的 Permission 和 BroadcastReceiver , 系统 就 可 
以 通过 Intent 来 唤醒 应 用 。 
。 不 提供 任何 内 置 的 用 户 界面 或 其 他 对 消息 数据 的 处 理 方法 。GCM 只 是 简单 地 把 原 
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始 数据 传递 给 Android 应 用 程序 ,而 程序 会 负责 如 何 处 理 消息 数据 。 
。 需要 可 以 运行 Android API 8 或 者 更 高 版 本 而 且 要 装 有 Google Play Store 的 设备 。 
。 使 用 现 有 的 Google 服务 连接 。 对 于 API 11 以 前 的 设备 ,需要 用 户 在 移动 设备 上 设 
fi Google 账户 。 运 行 Android API 14 或 更 高 版 本 的 设备 是 不 需要 Google 账户 的 。 
2. GCM 的 核心 组 件 
GCM 工作 的 核心 包括 两 个 方面 。 
(D 组 件 
GCM 包含 的 组 件 包 括 以 下 几 种 。 
。 移动 设备 : 运行 使 用 GCM 的 Android 应 用 的 设备 。 
。 第 三 方 应 用 服务 : 开发 人 员 用 以 作为 实现 GCM 一 部 分 的 应 用 服务 器 。 第 三 方 服务 
器 通过 GCM 服务 器 给 设备 上 的 应 用 发 送 数据 。 
。 GCM 服务 器 : Google 服务 器 从 第 三 方 服务 器 上 获取 数据 ,并 把 它们 发 送 到 移动 设备 上 。 
(2) 认证 
用 在 不 同 阶段 来 确认 各 方 都 已 经 被 认证 的 ID 和 令 牌 ,确保 消息 能 发 到 正确 的 地 方 。 
。 Sender ID; 从 API 控制 台 获 取 的 项 目 ID, Sender ID 被 用 在 注册 阶段 ,用 来 确认 
Android 应 用 是 否 已 经 被 允许 发 消息 给 设备 。 
Application ID; Android 程序 注册 应 用 程序 的 ID, 用 来 获得 消息 。Android 程序 是 
通过 AndroidManifest. xml 中 的 包 名 来 区 分 的 。 这 确保 该 消息 是 针对 正确 的 
Android 应 用 程序 。 
Registration ID: 由 GCM 服务 器 发 送 给 Android 应 用 ,人 允许 应 用 接收 消息 。 一旦 
Android 应 用 拥有 了 Registered ID, 就 把 它 发 送 给 第 三 方 应 用 服务 器 ,服务 器 用 它 
来 确认 哪些 设备 已 经 注册 了 并 且 正 准备 接收 消息 。 换 句 话 说 ,Registered ID 被 绑 定 
于 运行 在 特殊 设备 上 的 特殊 应 用 上 。 
Google 用 户 账号 : 为 了 GCM 的 工作 ,移动 设备 必须 至 少 包含 一 个 Google 账户 。 
消息 发 送 者 验证 令 牌 : 保存 在 第 三 方 应 用 服务 器 上 的 API key, 允许 服务 器 访问 
Google 服务 。API key 存在 于 消息 发 送 请 求 的 头 部 信息 里 。 


8.2.2 GCM 的 事件 序列 


1. 客户 端 事 件 序列 

以 下 是 移动 设备 上 的 应 用 注册 并 接收 消息 时 发 生 的 事件 序列 : 

(1) 第 一 次 应 用 使 用 消息 服务 时 ,给 GCM 发 送 一 个 注册 Intent。 该 Intent 的 动作 为 com. 
google. android. c2dm. intent. REGISTER ,并 包括 发 送 者 ID 和 Android 应 用 程序 的 ID. 

(2) 如 果 注 册 成 功 , GCM 会 广播 一 个 动作 为 com. google. android. c2dm. intent. 
REGISTER 的 Intent, 返 回 给 应 用 一 个 注册 ID。 应 用 会 在 以 后 用 到 这 个 ID( 例 如 ,会 在 
onCreate() 方 法 里 校 验 是 否 已 经 注册 )。 

注意 :Google 可 能 会 定期 刷新 注册 ID, 所 以 在 设计 应 用 的 时 候 , 要 认识 到 com. google. 
android. c2dm. intent. REGISTER 可 能 会 被 多 次 调用 。Android 应 用 程序 需要 能 够 做 出 相 
应 的 反应 。 

(3) 完成 注册 。Android 应 用 程序 把 注册 ID 发 送 到 应 用 程序 服务 器 。 服 务 器 把 注册 
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ID 存储 在 数据 库 中 。 注 册 ID 一 直 持 续 到 Android 的 应 用 程序 显 式 地 注销 它 , 或 者 Google 
对 它 进行 刷新 。 

(4) 发 送 消息 。 应 用 程序 服务 器 将 消息 发 送 到 一 个 Android 应 用 程序 时 ,必须 满足 如 
下 条 件 : 

。 应 用 必须 要 有 一 个 注册 ID ,这 样 允 许 它 在 一 个 特定 的 设备 上 接收 消息 。 

。 第 三 方 服务 器 已 经 存储 了 注册 ID。 

。 开发 者 必须 已 经 在 应 用 服务 器 上 为 应 用 准备 好 API key。 

(5) 接收 消息 。 手 机 收 到 消息 后 ,从 消息 中 提取 键 值 对 ,系统 使 用 com. google. 
android. c2dm. intent. RECEIVE Intent 把 键 值 对 传 给 目标 程序 , 目标 程序 从 RECEIVE 
Intent 中 根据 Key 取得 数据 并 处 理 数据 。 

2. 服务 端 时 间 序 列 

以 下 是 应 用 服务 器 发 消息 时 发 生 的 事件 序列 : 

CD 应 用 服务 器 给 GCM 发 消息 。 

(2) Google 会 给 消息 排序 并 存储 它们 ( 当 设 备 不 在 线 的 时 候 ) 。 

(3) 当 设 备 在 线 的 时 候 ,Google 会 把 消息 发 送 给 它们 。 

(4) 在 设备 上 ,系统 会 使 用 合适 的 权限 通过 Intent 广播 把 消息 广播 给 具体 的 应 用 。 消 
息 会 唤醒 接收 消息 的 应 用 。 

(5) 接收 并 处 理 消 息 。 设 备 上 的 应 用 接收 消息 时 ,接收 送 到 的 消息 并 从 消息 中 提取 键 
值 对 ,通过 com. google. android. c2dm. intent. RECEIVE 把 键 值 对 信息 发 送 给 应 用 ,应 用 通 
过 com. google. android. c2dm. intent. RECEIVE 提取 数据 并 加 以 处 理 。 


8.2.3 开发 云 信息 服务 


1. 创建 Google API 工程 

创建 一 个 Google API 工程 的 步骤 如 下 : 

(1) 打开 Google APIs Console 页 面 (https://code. google. com/apis/console) , 

(2) 如 果 未 曾 创建 一 个 API 工程 ,本 页 面 会 显示 创建 API 工程 的 提示 。 

如 果 已 经 有 工程 了 ,看 到 的 第 一 页 将 是 Dashboard 页 面 ,可 以 通过 打开 工程 下 拉 菜 单 的 
Other projects>Create 来 创建 一 个 新 的 工程 ,如 图 8-1 所 示 。 

(3) 创建 工程 后 再 单 击 它 ,浏览 器 会 变换 到 类 似 如 下 的 链接 : 





https://code. google. com/apis/console/b/0/?noredirect#project:670597347343 


# /project 的 值 (本 例 670597347343) 是 工程 的 ID ,会 在 后 面 作为 GCM 传送 ID. 
2. 激活 GCM 服务 
激活 GCM 服务 的 步骤 如 下 : 
(1) 在 Google APIs Console 主页 选择 Services, 打开 Google Cloud Messaging for 
Android 开关 。 如 图 8-2 所 示 。 
(2) 在 Service 页 的 Terms 中 选择 各 选项 。 
3. 获取 API Key 
获取 API Key 的 步骤 如 下 : 
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Google apis 
Project08 
Dashboard 
Overview 
Dre Project Summary Service Status 
Team Label Projectos Àj BigQuery API m No known issues 
API Access 
Billing Project 1D 670597347343 BI Debuglet Controller API ME No known issues 
Reports Project Name  dev-access-94414 Bi Google Cloud Logging API ME No known issues 
Quotas 
Q BigQuery Google+ Page Request connection BI Google Cloud SQL mt No known Issues 
X. Google Cloud SQL 
Owners njctee@gmail com - you © Google Cloud Storage 198 No known issues 
Google Cloud Storage 
Current charges Cack nere io administer your bing © Google Cloud Storage JSON API ma No known issues 
settings 
图 8-1 Google Dashboard 面板 
Google apis 
Project08 Y | AN(109) Active (7) Inactive (102) Google Cloud Platform 
nies All services 
Services Select services for the project. 
Team Service Status Notes 
API Accoss 
ty © Ad Exchange Buyer API e (Tor) Courtesy limit: 1,000 requests/day 
ing o 
Reports BI Ad Exchange Seller API © I Courtesy limit: 10,000 requests/day 
Quotas 
Q BigQuery Ai Google Cloud Messaging for Android 9 E^ 
Google Cloud SQL Ni Google Cloud Messaging for Chrome © e Courtesy imit: 10,000 requestsiday 
© Google Cloud Storage 
关 Google Cloud Monitoring API o (Tor Courtesy limit: 50,000 requests/day 


8-2 ”开启 Google Cloud Messaging for Android 


(1) 在 Google APIs Console 主页 选择 左 侧 的 API Access. 

(2) 在 API Access 页 面 , 单 击 Create new Server key 按钮 ,显示 Configure Server Key 
对 话 框 。 

(3) 在 “Accept requests from these server IP addresses:” 输 入 框 中 输入 服务 器 IP 地 址 
(可 选 ,不 输 也 可 以 ) , 单 击 “ 创 建 ” 按 钮 ,显示 如 图 8-3 所 示 的 创建 结果 (本 例 API key 结果 为 
AlzaSyDruFSRm81xHDeCNyF AH1K WhO3Gf381hMs) 。 

4. 创建 客户 端 应 用 

在 创建 Android 客户 端 应 用 之 前 ,需要 下 载 帮 助 库 。 方 法 是 在 SDK Manager 的 Extras 
中 选中 并 下 载 Google Cloud Messaging for Android Library。 下 载 完 成 后 ,在 Android 
SDK 路 径 下 的 /extras/google/ 文 件 夹 中 将 包含 一 个 GCM 文件 夹 , 含 如 下 子 目 录 : gem- 
client, gcm-server, samples/gcm-demo-client, samples/gcm-demo-server 和 samples/gcm- 
demo-appengine, 

然后 按照 如 下 步骤 创建 Android 应 用 。 

(1) 创建 Android 应 用 ,并 将 gem-client/dist 中 的 gem. jar 文件 添加 到 应 用 的 Java 
Build Path 中 , 

(2) 修改 应 用 的 AndroidManifest. xml 文件 。 包 括 以 下 方面 : 
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| Google apis 

| LProjecto8 Ez 

API Access 

| Overview. To prevent abuse, Google places limits on API requests. Using a valid OAuth token or API key allows you to exceed anonymous limits. 
Services. by connecting requests back to your project. 
SN Authorized API Access. 

| API Access 

| Billing Qj! OAuth 20 allows users to share specific data with you (for example o 

contact lists) while keeping their usemames, passwords, and other 
pons information private. A single project may contain up to 256 client 
| Quotas IDs. Leam more 


Q Bigduery Create an OAuth 2.0 client 
| X} Google Cloud SQL 


| Simple API Access 
Google Cloud Storage — RS keys to identify your project when you do not need to access user data. Leam more 








Key for server apps (with IP locking) Generate new key. 
API key RES 1xHDeCHyFA Edit allowed IPs. 
IPs Any IP allowed Delete key. 
Activated on: May 13, 2015 7:30 AM 


Activatedby:  njcitlee@gmail.com - you 


Create new Server key... | Create new Browser key... | Create new Android key... | Create new iOS key. 





图 8-3 Server Key 显示 界面 


(D WE. Android SDK 最 低 版 本 号 为 8, 声明 并 使 用 自 定义 权限 ,保证 只 有 此 应 用 程序 
才能 接收 GCM 信息 ,例如 : 


01 <permission 


02 android:name = "cn. liwy. project08. permission. C2D MESSAGE" 

03 android:protectionLevel = "signature" /> 

04 

05 «uses- permission 

06 android:name = "cn. liwy. project08. permission. C2D MESSAGE" /> 


此 permission “i tt 4 JJ app. package. permission. CZD MESSAGE(app. package 是 
应 用 程序 的 包 名 ,定义 在 AndroidManifest. xml 标签 中 ) ,以 防止 其 他 程序 注册 和 接收 这 个 
程序 的 消息 。 

@ 添加 如 下 permission: 


01 «uses- permission android: name = 

02 "con. google. android. c2dm. permission. RECEIVE" /> 

03 «uses- permission android: name = "android. permission. INTERNET" /> 

04 «uses- permission android: name = "android. permission. GET ACCOUNTS" /> 
android. permission. WAKE LOCK" /> 





05 <uses- permission android: name = 


这 些 权限 的 含义 是 : 
。 程序 拥有 注册 和 接收 消息 的 权限 。 
。 程序 拥有 联网 的 权限 。 
* GCM 需要 Google 账户 (设备 版 本 低 于 4.0 时 )。 
。 程序 可 以 保证 处 理 器 在 睡眠 时 被 唤醒 。 
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@ 在 一 application 之 标签 中 添加 如 下 BroadcastReceiver 声明 : 


01 «receiver 

02 android:name = "com. google. android. gcm. GCMBroadcastReceiver" 

03 android:permission = "com. google. android. c2dm. permission. SEND" > 
04 < intent- filter > 


05 <action android: name = "com. google. android. c2dm. intent. RECEIVE" /> 

06 <action android: name = "com. google. android. c2dm. intent. REGISTRATION" /> 
07 

08 < category android:name = "cn. njcit.project08" /> 

09 </intent - filter > 


10 </receiver > 


这 个 BroadcastReceiver 用 于 响应 处 理 GCM 传 给 的 两 个 Intent (com. google. android. 


c2dm. intent. RECEIVE 和 com. google. android. c2dm. intent. REGISTRATION) 。 通 过 设 
定 com. google. android. c2dm. permission. SEND 的 权限 ,确保 只 有 GCM 系统 框架 发 送 的 
Intent 才 发 送 给 该 广播 。 注 意 ,在 category 标签 里 的 android: name 必须 是 应 用 的 包 名 。 


以 下 是 GCMBroadcastReceiver 的 示例 : 


01 class GCMBroadcastReceiver extends BroadcastReceiver { 
02 @Overr ide 


03 public void onReceive(Context context, Intent intent) { 

04 String regId = intent 

05 . getStringExtra(Constants. FIELD_REGISTRATION_ID) ; 
06 sendIdToServer(regId) ; 

07 } 

08 ] 


(3) 编写 app. package. GCMIntentService 类 ,该 类 会 被 GCMBroadcastReceiver 调用 ,并 且 


必须 是 com. google. android. gem. GCMBaselntentService 的 子 类 ,必须 包含 一 个 公共 构造 方法 ， 
而 且 应 当 被 命名 为 app_package. GCMIntentService( 除 非 使 用 GCMBroadcastReceiver 的 子 类 重 
写 方法 来 命名 服务 ) 。 
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例如 : 


01 public class GCMIntentService extends GCMBaseIntentService { 
02 @Override 
03 protected void onRegistered(Context context, String regld) { 


04 Intent intent = new Intent(Constants. ACTION ON REGISTERED); 
05 intent. putExtra(Constants.FIELD REGISTRATION ID, regId); 

06 context. sendBroadcast( intent); 

07 y 

08 

09 @Override 

10 protected void onUnregistered(Context context, String regId) { 

ir Log.i(Constants. TAG, "onUnregistered: " + regId); 

12 } 

13 
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@Override 
protected void onMessage(Context context, Intent intent) { 
String msg = intent. getStringExtra(Constants. FIELD MESSAGE) ; 


NotificationManager manager = (NotificationManager) context 
.getSystemService(Context. NOTIFICATION SERVICE); 

Notification notification = prepareNotification(context, msg); 

manager.notify(R.id.notification id, notification); 


private Notification prepareNotification(Context context, String msg) { 
long when = System. currentTimeMillis(); 
Notification notification = new Notification( 
R.drawable.ic stat cloud,msg, when); 
notification. flags | = Notification. FLAG AUTO CANCEL; 


Intent intent - new Intent(context, MessageActivity.class); 
//Set a unique data uri for each notification to make sure the activity 
//gets updated 
intent. setData(Uri. parse(msg)) ; 
intent. putExtra(Constants.FIELD MESSAGE, msg); 
intent.addFlags(Intent.FLAG ACTIVITY NEW TASK 
| Intent.FLAG ACTIVITY CLEAR TASK); 
PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, 
intent, 0); 
String title = context. getString(R. string.app name); 
notification. setLatestEventInfo(context, title, msg, pendingIntent); 


return notification; 
@Override 


protected void onError(Context context, String errorId) { 
Toast.makeText(context, errorId, Toast.LENGTH LONG).show(); 


onRegistered( Context context, String regId) : 接收 到 一 个 注册 过 的 Intent 后 被 调 
用 ,作为 一 个 参数 传递 GCM 分 配 的 注册 ID 给 设备 中 相应 的 应 用 程序 。 典 型 地 ,应 
当 发 送 regid 给 服务 端 以 使 它 能 发 送 消息 给 设备 。 

onUnregistered(Context context, String regId) : 当 设 备 从 GCM 注销 注册 后 被 调 
用 ,典型 地 ,应 当 发 送 regid 给 服务 端 以 注销 设备 。 

onMessage(Context context, Intent intent): 当 服 务 端 发 送 消 息 给 GCM 调用 ， 
GCM 传送 给 设备 。 如 果 消 息 拥有 payload, 它 的 Content 可 以 作为 Intent 的 extras 
来 获得 。 

onError(Context context, String errorld); 当 设 备 试 图 要 注册 或 注销 ,但 GCM 返 
回 一 个 错误 时 调用 。 
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* onRecoverableError(Context context, String errorId) : (可 选 ) 当 设备 试图 要 注册 
或 注销 ,但 是 GCM 服务 不 可 获得 ,GCM 库 会 使 用 指数 备份 尝试 重复 操作 ,除非 此 
方法 被 重 写 且 返回 false。 此 方法 是 可 选 方法 ,只 有 当 想 显示 消息 给 用 户 或 取消 重复 
尝试 才 应 当 被 重 写 。 例 如 : 


01 @Override 
02 protected boolean onRecoverableError(Context context, String errorId) { 


03 Log.e(TAG, "Received recoverable error: " + errorId); 
04 return super. onRecoverableError(context, errorId); 
05 } 


上 面 的 这 些 方法 运行 在 IntentService 的 线程 ,可 以 任意 进行 网 络 调用 ,不 会 阻塞 UI 


线程 。 


228 


最 后 在 AndroidManifest. xml 中 添加 类 似 如 下 的 IntentService 声明 : 


01 «service android:name = "cn. liwy. project08. GCMIntentService" /> 


(4) 编写 应 用 的 主 Activity. 
应 用 的 主 Activity 的 onCreate() 方 法 一 般 为 : 


01 @Override 

02 public void onCreate(Bundle savedInstanceState) { 

03 super. onCreate(savedInstanceState); 

04 

05 

06 mGCMReceiver = new GCMBroadcastReceiver(); 

07 mOnRegisteredFilter - new IntentFilter(); 

08 mOnRegisteredFilter.addAction(Constants. ACTION ON REGISTERED); 
09 

10 if (Constants. SENDER_ID == null) { 


11 mStatus. setText ("Missing SENDER ID"); 
12 return; 

i3 } 

14 if (Constants. SERVER_URL == null) { 

15 mStatus.setText("Missing SERVER URL"); 
16 return; 

17 } 

18 


19 GCMRegistrar. checkDevice(this); 

20 GCMRegistrar. checkManifest(this); 

21 final String regId - GCMRegistrar. getRegistrationId(this); 
22 if (!regId. equals("")) { 


23 sendIdToServer(regld); 

24 } else ( 

25 GCMRegistrar. register(this, Constants.SENDER ID); 
26 } 

27 } 
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checkDeviceO 7; iE fg # GCM 的 设备 系统 版 本 及 是 否 装 有 Google Service Frame 
(GCM 服务 需要 安装 有 谷歌 服务 包 , 且 系统 版 本 2. 2 及 以 上 的 才 支 持 ) ,如 果 不 支 持 则 抛 出 
异常 。 代 码 如 下 : 


01 private boolean checkDevice() ( 
02 int resultCode - GooglePlayServicesUtil 


03 . isGooglePlayServicesAvailable(this); 

04 if (resultCode != ConnectionResult.SUCCESS) { 

05 if (GooglePlayServicesUtil. isUserRecoverableError(resultCode)) { 
06 GooglePlayServicesUtil. getErrorDialog(resultCode, this, 
07 PLAY SERVICES RESOLUTION REQUEST). show( ) ; 

08 } else { 

09 Log. i(TAG, "This device is not supported. "); 

10 finish(); 

1i } 

12 return false; 

13 } 

14 return true; 

aby 


类 似 地 , checkManifest CO 验证 应 用 的 AndroidMenifest. xml 是 否 包 含 了 在 编写 
Android 应 用 所 要 求 的 条 件 。 一 旦 完成 合理 的 验证 ,设备 调用 GCMRegsistrar. register() 来 
注册 设备 ,传递 注册 时 获得 的 SENDER_ID。 可 以 先 调 用 CMRegistrar. getRegistrationId() 
来 确认 设备 是 否 已 经 注册 。 然 后 当 注 册 的 Intent 到 来 后 ,GCMRegistrar 单独 跟踪 注册 ID. 


8.2.4 Google App Engine 


Google App Engine( 简 称 GAE) ,是 Google 在 2008 4E Campfire One 上 推出 的 支持 
Python、Java、Go 和 了 PHP 语言 的 云 引擎 。GAE 是 一 种 简化 创建 .运行 和 构建 伸缩 性 Web 
应 用 的 工具 ,用 户 可 以 在 Google 的 基础 架构 上 构建 Web 应 用 并 将 其 部 署 到 Google 基础 设 
施 之 上 。GAE 易于 构建 和 维护 ,并 可 根据 访问 量 和 数据 存储 需要 的 增长 轻松 扩展 。GAE 
对 全 球 开发 者 免费 开放 使 用 ,可 以 充分 利用 Google 提供 的 免费 空间 、 免 费 数据 库 、 免 费 二 级 
域名 等 来 展示 自己 的 应 用 程序 ,提供 给 全 球 的 用 户 下 载 和 使 用 。 

1. 注册 GAE 

注册 GAE 的 步骤 如 下 : 

(1) 注册 Google Gmail 邮箱 (网 址 为 https://accounts. google. com/signup) 并 完成 
验证 。 

(2) 登录 Google App Engine( 网 址 为 https://appengine. google. com/), 显 示 如 图 8-4 
所 示 。 

(3) 单 击 Create Application 按钮 ,显示 如 图 8-5 所 示 。 

(4) f£ Application Idenifier 的 appspot. com 之 前 的 输入 框 中 输入 要 上 传 的 appid ,如果 
已 经 有 人 使 用 该 appid 创建 过 了 , 则 提示 失败 。 在 Application Title 部 分 的 输入 框 中 填 人 应 
用 标题 部 分 (可 随意 填 人 ) ,其 他 选项 缺 省 设置 。 单 击 底部 的 Create Application, 显示 如 
8-6 所 示 ,表明 appid 建立 成 功 。 
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Google appengine njcit.lee@gmail.com 


Welcome to Google App Engine 


Before getting started, you want to leam more about developing and deploying applications. 
Leam more about Google App Engine by reading the Getting Started Guide, the FAQ, or the Developer's Guide. 





图 8-4 Google App Engine 页 面 


Google app engine njcit.lee@gmail.com | My Account | Help | Sign out 


Create an Application 


You have 24 applications remaining 
Application Identifier: 








-appspot.com 
Al Google account names and certain offensive or rademarked names may not be used as Application identifiers. 
You can map this application to your own domain later. Leam more 


Application Title: 

















Displayed when users access your application. 


‘Authentication Options (Advanced): Leam more 
Google App Engine provides an API for authenticating your users, including Google Accounts, Google Apps , and OpenID. If you choose to use this feature for some 
parts of your site, youll need to specify now what type of users can sign in to your application: 
© Open to all Google Accounts users (default) 
If your application uses authentication, anyone with a valid Google Account may sign in. 


© Restricted to the following Google Apps domain: 














eg ioocom 


Ifyour application uses authentication, only members of this Google Apps domain may sign in It your organization uses Google Apps, use this option to create an 
application (e.g. an HR tracking tool) that is only accessible to accounts on your Google Apps domain. This option cannot be changed once it has been set. 


© (Experimental) Open to all users with an OpenID Provider 
If your application uses authentication, anyone who has an account with an OpenID Provider may sign in 





8-5 创建 Google App Engine 应 用 页 面 


Google app engine njcit-lee@gmail.com | My Account | Help | Sign out 


Application Registered Successfully 
The application will use njcit2015 as an identifier. This identifier belongs in your application's configuration as well. Note that this identifier cannot be changed. 


‘The application uses the High Replication storage scheme. Leam more 

If you use Google authentication for your application, Contact App wil be displayed on Sign In pages when users access your application. 
Choose an option below: 

* View the dashboard for Contact App. 

* Use appcíg to upload and deploy your application code. 

» Add administrators to collaborate on this application. 
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(5) 单 击 dashboard 链接 ,显示 如 图 8-7 所 示 。 








Google app engine njcit.lee@gmail.com | My Account | Help | Sian out 
Application: njcit2015 [High Replication] Try the new Dashboard. Community Support « My ications 


ue Q9 You need to upload and deploy an application before you can make Web history. 








‘Dashboard Read about using appcfg to upload and deploy one. 
ax Charts © 
logs No Data Available 
Versions. r 
Cron Jobs 
Task Queues : 
Quota Details 3 
Data Ei 
latastore Indexes 1 
Datastore Viewer 
Datastore Statistics D p Ta [ ‘ne Tow 
Blob Viewer 
Pi tiv " Instances © 
Text Seach App Engine Release Total number of instances Average QPS* Average latency! Average Memory 
Datastore Admin aa 
Memcache Viewer Billing Status: Free - Settings Quotas reset every 24 hours. Next: € 
hrs’ 
Administration a Usage 


8-7 Google App Engine 应 用 于 Dashboard 面板 


后 续 可 以 通过 Eclipse 上 传 应 用 项 目 。 

2. 安装 GPE 插件 

Google Plungin for Eclipse( 简 称 GPE) Æ Google 推出 的 一 款 Eclipse 插件 ,使 用 该 插 
件 ,可 以 从 Eclipse 中 创建 ,测试 和 上 传 App Engine 应 用 程序 , 它 同时 支持 Google Web 
Toolkit(GWT) 开 发 。 据 Google Web Toolkit 的 官方 博客 介绍 ,GPE 其 实 包括 了 一 系列 软 
件 开发 工具 ,用 于 帮助 Java 开发 者 快速 设计 、 构 建 、 优 化 及 部 署 那 些 基于 云 的 应 用 程序 一 一 
使 用 GWT,Speed Tracer, App Engine 及 其 他 Google 云 服 务 。 

安装 GPE 插件 的 步骤 是 : 

(1) 启动 Eclipse, 执 行 Help — Install New Software... 命 令 ,打开 Install 对 话 框 。 

(2) 在 Install 对 话 框 中 单 击 Add 按钮 ,打开 Add Repository 对 话 框 ,如 图 8-8 所 示 。 


@ Add Repository 








Name: — Google Plungin 


Location: https://dl.google.com/eclipse/plugin/4.4 





® 




















8-8 安装 GPE 插件 


(3) 在 Location 输入 框 中 输入 https: //dl. google. com/eclipse/plugin/4.4(4. 4 是 根据 
Eclipse 的 版 本 号 选择 的 ,不 同 版 本 Eclipse 的 插件 下 载 地 址 不 同 , Luna 版 本 号 是 4. 4. 
Kepler 是 4. 3,Juno 是 4. 2, 访 问 https://developers. google. com/eclipse/docs/download 
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可 以 查看 更 多 不 同 版 本 的 下 载 地 址 ) , 单 击 OK 按钮 。 

(4) 在 打开 如 图 8-9 所 示 的 Install 对 话 框 中 ,选中 必要 的 Google Plugin for Eclipse 
Crequired) ,并 单 击 Next 按钮 。 








f — [m ES 
cu WS T 15 RIS . = 


Available Software 
Check the items that you wish to install. 


Work with: 3oogle Plus - jarsfle:/C:/Users/DELL/Desktop/gpe-e42-latest-updatesitezip!/ ~ [ — Add. 
Find more software by working with the “Available Software Sites" preferences. 























|| type filter text 





|| Name 
||| > E m Google App Engine Tools for Android (requires ADT) 
4 [V] Iii Google Plugin for Eclipse (required) 
T & Google Plugin for Eclipse 4.2 
> 000 GWT Designer for GPE (recommended) 
4 T J ' 


| Deselect All] — litem selected 


Details 

















[V] Show only the latest versions of available software Hide items that are already installed 
| IV] Group items by category What is already installed? 

Show only software applicable to target environment 

El Contact all update sites during install to find required software 





@ {<Back (GNet) | Frish Cancel 


























8-9 GPE 插件 安装 详细 信息 


(5) 阅读 所 要 安装 内 容 的 细节 及 相关 条 款 ,选中 I accept the terms of the license 
agreements 单 选 按钮 ,从 而 确认 进入 下 一 步 安装 。 

(6) 重启 Eclipse, 在 工具 栏 可 以 看 到 如 图 8-10 所 示 的 工具 。 

3. 安装 GWT SDK 

Google Web Toolkit( 简 称 GWT) J& Google 推出 
的 Ajax 应 用 开发 包 ,GWT 支持 开发 者 使 用 Java 语言 
开发 Ajax 应 用 。GWT 提供 了 一 组 基于 Java 语言 的 
开发 包 , 这 个 开发 包 的 设计 参考 Java AWT 包 设 计 , 类 
命名 规则 、 接 口 设计 、 事 件 监听 等 都 和 AWT 非常 
类 似 。 

安装 GWT SDK 的 步骤 是 : 

OD 下 载 GWT SDK( 下 载 地 址 为 http://www. 
gwtproject. org/download. html) 。 


9- P 4 [s m 
Qj New Web Application Project... 
Import App Engine Sample Apps... 
Import Apps Script Project... 

Import Google Hosted Project... 





GWT Compile Project... 
Profile Using Speed Tracer... 


Deploy to App Engine... 
Add Google APIs... 


5 
za 
ü 
e 
ô 
5 
e 





图 8-10 GPE 工具 栏 
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(2) 启动 Eclipse. #47 Window Preferences 命令 ,打开 Preferences 对 话 框 。 

(3) Æ Preferences 对 话 框 中 展开 左 侧 的 Google/Web Toolkit, 单 击 Add 按钮 ,在 打开 
的 Add GoogleWeb Toolkit SDK 对 话 框 中 单 击 Browse 按钮 ,选择 下 载 的 GWT SDK ,如 图 
8-11 所 示 。 
























































@ Preferences —— Rm =|) X 
(type filter text — ^ — | | Web Toolkit e-o-v 
P Sahara! * | Add, remove or download SDKs. 
b Android 
» C/C++ By default, the checked SDK is added to the build path of newly 
» Data Management created projects. 
4 Google spk 
App Engine 
Errors/Wamings Name Versi. Location Add... 
Speed Tracer E [V| BÀgwt-20.2 2.0.2  DAApp Engine\gwt-2.0.2 prem 
» [Web Toolkit 二 一 一 一 
> Help Download... 
> Install/Update 
> Java 
Java EE 
> Java Persistence 
> JavaScript 
> Run/Debug 
> Server | , 
> Team 2 
9 (ox) Eom.) 
M d 














图 8-11 安装 GWT SDK 


4. 安装 Google App Engine for Java SDK 

Google App Engine for Java 为 企业 Java 开发 提供 了 一 个 端 到 端的 解决 方案 : 一 个 易 
于 使 用 的 基于 浏览 器 的 Ajax GUI, Eclipse 工具 支持 以 及 后 端的 Google App Engine, AF 
使 用 和 工具 支持 是 Google App Engine for Java 优 于 其 他 云 计算 解决 方案 的 两 大 优势 。 

安装 Google App Engine for Java WARE: 

(D F Google App Engine for Java( 下 载 地 址 为 https://cloud. google. com/ 
appengine/downloads) 。 

(2) 启动 Eclipse, 执 行 Window — Preferences 命令 ,打开 Preferences 对 话 框 。 

(3) 在 Preferences 对 话 框 中 展开 左 侧 的 Google/App Engine, 单 击 Add 按钮 ,在 打开 
的 Add App Engine SDK 对 话 框 中 单 击 Browse 按钮 ,选择 下 载 的 Google App Engine for 
Java SDK, 如 图 8-12 所 示 。 


8.2.5 创建 服务 端 应 用 


本 小 节 通 过 App Engine for Java 来 构建 云 信息 服务 端 。 步 又 如 下 : 
(1) 在 安装 完 Google Cloud Messaging for Android Library 后 ,Android SDK 目录 下 
有 一 个 extras/google/ 目录 ,进入 samples/gcm-demo-appengine 目录 。 
(2) 打开 gcm-demo-appengine/src/com/google/android/gcm/demo/server/ E 3€ F Ay 
ApiKeylnitializer. java 文件 ,用 8. 2. 3 小 节 获 取 的 API Key 替换 掉 entity. setPropertyO F 
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@ Preferences — 全 一 A— — o Sey =x 
— 
[type filter text App Engine Cro 
y Gon ^, | Add, remove or download SDKs. 
> Android 
b C/C++ By default, the checked SDK is added to the build path of newly created projects. 
> Data Management ee 
4 Google 
[App Engine| Name Versi... Location Addex. 
Errors/Warnings E] BAappengin... 19.3 Di\App Engine\appengine-java-sdk-1.9.3 


Re 
Speed Tracer |.] Loe | 


D Web Toolkit Download... 
» Help 
» Install/Update 
Java 
Java EE 
Java Persistence 











b 
> JavaScript 
D Run/Debug 
[ 
b 








SS | 
Server z t 


Team - 








® (ox) om... 




















8-12 安装 Google App Engine for Java 


法 里 的 replace this text by your Simple API Access key 文本 。 

(3) 下 载 并 解压 安装 Ant 工具 (下 载 地 址 为 http://ant. apache. org/bindownload. 
cgi) ,配置 Ant 环境 变量 。 

(4) 打开 命令 行 窗口 ,进入 gcm-demo-appengine 所 在 的 文件 夹 ,运行 如 下 命令 : 


ant - Dsdk. dir = D:\\App runserver - Dserver.host = 192.168.0.105 


其 中 ,-Dsdk. dir ff] f Jj appengine-java-sdk 所 在 的 文件 夹 ,-Dserver. host 是 服务 器 的 
IP 地 址 。 
如 果 相 关 配 置 和 命令 执行 正确 ,在 命令 行 窗口 显示 类 似 如 下 的 信息 : 


Buildfile: C:\Users\DELL\workspace2015\gcm— demo - appengine\ build. xml 

init: 

copyjars: 

compile: 

datanucleusenhance: 
[enhance] DataNucleus Enhancer (version 1.1.4) : Enhancement of classes 
[enhance] DataNucleus Enhancer completed with success for 0 classes. Timings : 

input = 91 ms, enhance = 0 ms, total = 91 ms. Consult the log for full details 
[enhance] DataNucleus Enhancer completed and no classes were enhanced. Consult 

the log for full details 


(5) 打开 浏览 器 输入 http: //192. 168. 0. 105:8080/, i 5 Sd zs An 8-13 所 示 的 界面 信 
息 , 说 明 服务 端 部 署 成 功 。 
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GCM Demo 








> © [M 192.168.0.105:8080 








图 百度 一 下 ,你 就 0 道 。 的 新 浪 首页 9 ABEM 








No devices registered! 





8-13 ”服务 端 界面 


(6) 在 设备 上 添加 Google 账号 (在 Android 4.0 及 以 上 版 本 中 ,添加 账号 是 可 选 的 ,也 
就 是 可 以 省 掉 添加 账号 这 一 环节 ) ,添加 账号 的 位 置 如 图 8-14 所 示 。 





Settings 


Personal 


9 Location 


@ — Security 








©) Personal (IMAP) 


® Language & input 











图 8-14 添加 Google 账户 


(7) 启动 Android 客户 端 应 用 ,刷新 浏览 器 ,此 时 将 显示 设备 已 经 成 功 注册 ,客户 端 和 
服务 端 可 以 开始 通信 。 


8.3 Google Drive 


Google Drive 是 Google 的 一 个 在 线 同步 存储 服务 ,并 提供 了 如 下 核心 功能 : 

。 结合 Google Docs 的 在 线 文件 预览 与 编辑 功能 。 

。 版 本 控制 功能 ,一 个 文件 可 以 保存 30 天 内 的 各 个 修订 版 本 ,并 且 仅仅 只 有 当前 最 新 
的 文件 占用 空间 。 

* 强大 和 完善 的 共享 、 协 作 功 能 ,可 以 创建 简单 的 共享 链接 供 所 有 人 浏览 评论 ,还 可 
以 很 轻松 地 创建 共享 文件 和 文件 夹 , 实 现 团 队 或 朋友 之 间 的 文档 共享 ,共同 维护 和 
编辑 文档 。 

。 与 Gmail、Google 十 Photos 的 整合 ,提高 了 用 户 体 验 。 

说 明 : 当 用 户 将 资料 上 传 或 提交 到 Google Drive 上 时 ,用 户 即 授权 Google( 以 及 与 

Google 合作 的 公司 ) 在 世界 范围 内 使 用 .托管 、 存 储 、 复 制 、 修 改 . 再 创作 (如 翻译 、 改 写 或 其 
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他 能 够 使 用 户 的 内 容 与 Google Drive 的 服务 更 匹配 的 改变 )、 传 播 、 出 版 .公共 场合 演示 或 
分 发 资料 的 权利 。 用 户 授予 的 这 些 权利 仅 会 用 在 Google Drive 的 运行 维护 、 产 品 升级 和 服 
务 提升 等 有 限 的 用 途上 ,即便 用 户 停止 使 用 Google Drive, 该 服务 条 款 仍然 生效 。 


8.3.1 获取 Google Drive API Key 


获取 Google Drive 应 用 的 基本 步骤 如 下 。 
(1) 安装 Google Play services SDK. 
安装 Google Play services SDK 的 方法 如 下 : 
在 Eclipse 中 ,执行 菜单 命令 Windows—> Android SDK Manager, 进 入 Android SDK 
Manager 对 话 框 , 安 装 如 下 3 个 项 目 。 
* Android 版 本 号 /Google APIs( 可 选 ) 
e Extras/Android Support Library 





* Extras/Google Play services 

(2) 注册 Google Drive 应 用 。 

注册 Google Drive 应 用 的 方法 如 下 : 

如 果 没 有 创建 应 用 项 目 ,参照 8. 2. 3 小 节 创 建 一 个 Android 应 用 。 

(3) 获取 认证 指纹 。 

获取 认证 指纹 的 方法 如 下 : 

在 Eclipse 中 ,执行 菜单 命令 Windows- Preferences Android— Build, 3T JT in KI 8-15 


所 示 对 话 框 。 
























































| Build vr 
mE ^. | Build settings: 
uc [V] Automatically refresh Resources and Assets folder on build 
DDMS r [V] Force error when external jars contain native libraries 
Launch Build output 
Logcat @ silent 
Usage Stats 3 © Normal 
Ant © Verbose 
EMF Compare | 
Help Default debug keystore: | C:\Users\azul\.android\debug.keystore 
Install/Update Custom debug keystore: Browse... 
| Java 
i MF. ai 
IN ow — T j^ Restore Defaults Apply 
Ilo OK Camel ) 





图 8-15 Preferences 对 话 框 


其 中 的 Default debug keystore 即 为 debug keystore 的 位 置 。 
打开 命令 行 窗口 ,执行 如 下 命令 : 


keytool - list — alias androiddebugkey - keystore "C:\\Users\\DELL\\. android\ \ debug. 
keystore” - storepass android 一 keypass android (注意 : 双 引 号 内 不 得 含 空 格 ) 
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keytool 为 jdk 中 的 命令 ,如 果 没 有 配置 JDK 环境 变量 , 则 进入 jdk/bin 目录 中 执行 该 
命令 。 显 示 结果 如 图 8-16 所 示 。 











B SEA: CMWindows\system32\cmd.exe N = Sri") 
icrosoft Windows [版 本 6.1.76011 n 
权 所 有 <c) 2089 Microsoft Corporation. {RMAT AIWF. IE 






?Wsers\DELL>cd \ 


:\>keytool -list -alias androiddebugkey -keystore “C:\Wsers\DELL\.android\debu 
keystore” -storepass android -keypass android 

droiddebugkey, 2014-6-38, PrivateKeyEntry, 

证 书 指 纹 《SHA1》: D3:BC:C8:EF:9B:89:13:82:9D:E8:BC:2C:29:37:1E:7D:74:70:5C:FR 

:>, 














8-16 获取 认证 指纹 


其 中 SHA1 那 一 行 就 包含 了 证 书 的 SHA-1 认证 指纹 , 它 是 二 十 段 用 冒号 割 开 的 数字 
段 ,每 段 是 两 个 十 六 进 制 的 数 。 

(4) 获取 API Key. 

获取 API Key 的 方法 如 下 : 

在 Web 浏览 器 中 打开 网 址 https://code. google. comyapis/console, 单 击 左 侧 APIs & auth 
下 的 APIs, 选 择 右 侧 的 Enabled APIs 标签 页 ,查看 Drive API 是 否 被 激活 ,如 图 8-17 所 示 。 








Google Project08 ~ Signup fora free tial f) € @ 
Overview API Library Enabled APIs (8) 
Permissions ea os 
Some APls are enabled automatically. You can disable them if youre not using 
APIs & auth their services 
APIs 
API ^ Quota 
Credentials 
BigQuery API 0% Disable 
concen aren Debuglet Controller API 0% Disable 
des Drive API 0% 
Monitoring Google Cloud Logging API OX Disable 
Source Code Google Cloud Messaging for Android Disable 
Compute Google Cloud SQL Disable 
Deploy & Manage Google Cloud Storage Disable 
Networking Google Cloud Storage JSON API Disable — € 


Storage 
Cloud Rintable 


图 8-17 激活 的 API 列 表 


(5) 单 击 左 侧 的 Credentials, 这 时 分 以 下 两 种 情况 。 
CD 应 用 需要 提交 授权 
方法 是 : 在 OAuth 中 单 击 Create new Client ID 按钮 ,在 弹出 的 对 话 框 中 选择 Installed 
application, TE Installed application type 中 选择 Android, 在 Package name 输入 框 中 输入 应 
用 项 目的 包 名 ,在 Signing certificate fingerprint (SHA1) 输入 框 中 输入 上 一 步 得 到 的 
SHA1, 单 击 Create Client ID 按钮 ,显示 如 图 8-18 所 示 的 API Key 信息 。 
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Client ID for Android application 
Client ID 670597347343-mv159im99n9pltpkefd064sf163v6jip.apps.googleusercontent.com 
Redirect URIs um:ietf.wg:oauth:2.0:00b 

http://localhost 
Package name cn.liwy.project08 
Bi fingerprint D3:BC:C8:EF:9B:89:13:82:9D:E8:BC:2C:29:37:1E:7D:74:70:5C:FA 
Deep linking Disabled 


| Edit settings | Download JSON | | Delete 


8-18 授权 API Key 获取 界面 


@ 应 用 只 是 调用 API, 不 需要 授权 

在 Public API access 中 单 击 Create new Key 按钮 ,在 弹出 的 对 话 框 中 选择 Android 
key, 在 文本 输入 框 中 输入 上 一 步 得 到 的 SHA1 并 以 英文 分 号 结束 ,再 加 上 应 用 程序 包 的 名 
称 , 如 图 8-19 所 示 。 


Create an Android key and configure allowed Android applications 


This key can be deployed in your Android application. 


API requests are sent directly to Google from your client Android device. Google verifies that each request 
originates from an Android application that matches one of the certificate SHA1 fingerprints and package 
names listed below. You can discover the SHA1 fingerprint of your developer certificate using the following 
command: 


keytool -list -v -keystore mystore. keystore 
Learn more 


Accept requests from an Android application with one of the certificate fingerprints and package names 
listed below (Optional) 

One SHA1 certificate fingerprint and package name (separated by a semicolon) per line. Example: 
45:B5:E4-6F-36:AD-0A:98:94:B4:02:66:2B-12:17:F2-56:26:A0:E0;com.example 

Or if you leave this blank, requests will be accepted from any Android application. Be sure to add SHAT 
certificates before using this key in production 


03:BC:C8:EF-98-89:13:82:9D-E8-BC:2C:29:37-1E:7D:74:70:5C:FA‘cn liwy.projectO8| 














4 





8-19 Create an Android key and configure allowed Android applications 界面 


单 击 Create 按钮 ,显示 如 图 8-20 所 示 的 API Key 信息 。 


Key for Android applications 
API key AlzaSyDc_SPoQuSOUMScSuGiGPv_jLvynxGW98U 
Android applications D3:BC:C8:EF:98:89:13:82:9D:E8:BC:2C:29:37:1E:7D:74:70:5C:FA;cn liwy.project08 
Activation date May 16, 2015, 12:26:00 PM 
Activated by njcitlee@gmail.com (you) 


| Edit allowed Android applications Regeneratekey | | Delete 


图 8-20 非 授权 API Key 获取 界面 
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8.3.2 创建 授权 Google Drive 应 用 


下 面 基 于 Google Drive for Android 创建 一 个 应 用 , 主 界面 授权 登录 成 功 后 , 以 
ListView 的 形式 显示 网 络 磁盘 的 文件 。 设 计 效 果 如 图 8-21 所 示 。 


& Open a Drive item 


an 


Work Folder 


FOLDERS 


Delivery Data 


Expanded Project Information 


Select 


Cancel 


g 


步骤 如 下 : 
(1) 创建 Android Jii H ,并 在 AndroidManifest. xml 中 添加 如 下 权限 信息 : 


01 
02 
03 
04 
05 
06 


X uses - permission android: 
X uses - permission android: 
«uses - permission android: 
X uses - permission android: 
« uses - permission android: 
« uses - permission android: 


图 8-21 Google Drive 应 用 


name = "android. permission. 
name = "android. permission. 
name = "android. permission. 
name = "android. permission. 
name = "android. permission. 
name = "android. permission. 


. INTERNET" /> 

.WRITE EXTERNAL STORAGE" /> 
. GET ACCOUNTS" /> 

.USE CREDENTIALS" /> 

. MANAGE ACCOUNTS" /> 

. READ GSERVICES" /> 


(2) Æ Activity 的 onCreate() 生 命 周期 方法 中 实现 授权 认证 ,代码 如 下 : 


01 
02 
03 
04 
05 
06 


settings 


getPreferences(MODE PRIVATE); 


accountName - settings.getString(PREF ACCOUNT NAME, null); 
credential.setAccessToken(settings.getString(PREF AUTH TOKEN, null)); 
Logger. getLogger( "com. google. api.client").setLevel(LOGGING LEVEL); 
accountManager - new GoogleAccountManager(this); 


gotAccount(); 
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首先 从 SharedPreferences 中 获取 以 往 的 授权 信息 ,初始 化 GoogleAccountManager, 然 
后 调用 gotAccount() 方 法 进行 授权 认证 ,代码 如 下 : 


01 void gotAccount() { 


02 Account account = accountManager. getAccountByName( accountName) ; 

03 if (account == null) ( 

04 chooseAccount( ) ; 

05 return; 

06 } 

07 if (credential. getAccessToken() != null) { 

08 onAuthToken( ) ; 

09 return; 

10 } 

m accountManager. get AccountManager( ) . gethuthToken(account, 

12 AUTH TOKEN TYPE, true, new AccountManagerCallback < Bundle »() { 

13 

14 public void run(AccountManagerFuture « Bundle » future) ( 

15 try { 

16 Bundle bundle = future. getResult() ; 

17 if (bundle. containsKey(AccountManager. KEY_INTENT)) { 
18 Intent intent = bundle 

19 .getParcelable(AccountManager.KEY INTENT); 
20 intent. setFlags(intent.getFlags() 

21 & —Intent.FLAG ACTIVITY NEW TASK); 

22 startActivityForResult(intent, 

23 REQUEST_AUTHENTICATE) ; 

24 } else if (bundle 

25 .containsKey(AccountManager. KEY AUTHTOKEN)) { 
26 setAuthToken(bundle 

27 .getString(AccountManager. KEY AUTHTOKEN)); 
28 onAuthToken( ) ; 

29 } 

30 } catch (Exception e) { 

31 Log. e(TAG, e. getMessage(), e); 

32 } 

33) } 

34 }, null); 

sE 


如 果 授 权 成 功 ,调用 onAuthToken() 方 法 异步 加 载 Google Drive 中 的 文件 。 
(3) 实现 异步 加 载 文件 的 AsyncTask 实例 ,核心 代码 如 下 : 


01 public class AsyncLoadFiles extends AsyncTask < Void, Void, List <String>> { 


02 

03 on 

04 public AsyncLoadFiles(GoogleDriveActivity driveSample) { 
05 this.driveSample = driveSample; 

06 service = driveSample. service; 

07 dialog = new ProgressDialog(driveSample) ; 
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08 
09 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
4l 
42 
43 
44 
45 
46 
47 
48 
49 
50 
DL 
52 
53 
54 


@Override 

protected void onPreExecute() { 
dialog. setMessage("Loading root..."); 
dialog. show() ; 


@Override 
protected List < String> doInBackground(Void... arg0) { 


try { 
About about = service. about().get(). execute(); 


List < String> result = new ArrayList < String >(); 
rootFile = service. files().get(about. getRootFolderId()). execute() ; 
result. add(rootFile. getTitle()); 
return result; 
} catch (IOException e) { 
driveSample. handleGoogleException(e); 
return Collections. singletonList(e.getMessage( ) ); 
) finally ( 
driveSample. onRequestCompleted() ; 


@Override 
protected void onPostExecute(List «String» result) { 
dialog. dismiss() ; 
driveSample. setListAdapter(new ArrayAdapter < String >(driveSample, 
android. R. layout. simple_list_item_1, result) ); 
driveSample. getListView(). setOnItemClickListener( 
new OnItemClickListener() { 


@Override 
public void onItemClick(AdapterView <?> arg0, View argl, 
int arg2, long arg3) { 
Intent intent = new Intent(driveSample, 
DocListActivity. class) ; 
intent.putExtra(DocListActivity.KEY ROOT FOLDER ID, 
rootFile. getId()); 
intent. putExtra(DocListActivity. KEY_AUTH_TOKEN, 
driveSample. credential. getAccessToken() ) ; 
driveSample. startActivity( intent); 


H: 
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其 中 ,19 一 24 行 获取 Google Drive 根 路 径 下 的 文件 集合 ,然后 通过 33 一 53 行 的 
onPostExecute() 回 调 方法 ,将 集合 数据 提交 给 基于 BaseAdapter 的 DocListAdapter if At 
器 ,最 终 将 文件 信息 显示 在 ListView 中 。 同 时 ,该 方法 实现 了 ListView 中 每 个 Item 的 单 
击 事件 , 即 跳 转 到 DocListActivity 界面 ,如 果 单 击 的 是 文件 夹 , 则 加 载 该 Item 的 子 文件 夹 
信息 。 

如 果 单 击 的 是 文件 , 则 图 8-22 演示 了 Drive File 操作 的 生命 周期 流程 ,有 关 Google 
Drive API 的 详细 信息 ,请 参阅 https://developer. android. com/reference/com/google/ 


android/gms/drive/package-summary. html, 
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8-22 Drive File 操作 的 生命 周期 


8.4 =] 题 


1. 编程 实现 基于 BackupAgentHelper 的 文件 备份 功能 。 
2. 编程 实现 基于 Google Drive 的 文本 文档 的 在 线 编辑 功能 。 
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Philm? 是 Chris Banes 在 GitHub 上 发 布 的 一 个 关于 电影 信息 的 开源 Android 应 用 。 
项 目 基 于 Apache v2. 0 许可 协议 ,使 用 Trakt® 和 TMDB® 开放 接口 。 


9.1 JI Hi igi jr 


启动 应 用 后 ,显示 如 图 9-1 所 示 的 主 界面 ,主要 是 侧 边栏 中 "发 现 ” 模 块 的 信息 。 

。 流行 : 显示 最 近 观 看 和 关注 较 多 的 影片 信息 。 

。 上映 中 : 正在 热 映 的 影片 信息 。 

。 即将 上 映 : 即将 上 映 的 影片 信息 。 

。 推荐 : Trakt 推荐 的 影片 信息 。 

以 上 四 个 板块 实现 拖 动 刷新 。 单 击 界面 左上 角 的 汪 按 钮 ,激活 侧 边栏 ,包括 登录 发 
现 , 我 的 收藏 夹 、 观 看 列表 和 搜索 菜单 ,如 图 9-2 所 示 。 











y 
与 激情 7 
Wü n 
Boo sek 
E nana 
Q 搜索 
图 9-1 应 用 主 界面 图 9-2 侧 边 菜单 


@ 项 目 主页 为 https://github. com/chrisbanes/philm。 

©  Trakt(https://trakt. tv/) 是 一 个 在 线 电 视 剧 、 电 影 媒 体 资 源 追 踪 平 台 ,用 户 可 以 通过 多 设备 工具 来 使 用 Trakt 
平台 发 现 自 己 喜 欢 的 电影 ,追踪 最 新 的 内 容 动态 ,预定 电视 剧 最 新 剧 集 。 

G TMDB(https:/ /www. themoviedb. org/) 是 一 个 提供 电影 .演员 等 信息 的 在 线 数据 库 。 
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单 击 主 界面 的 任 一 电影 海报 ,启动 电影 详情 界面 ,如 图 9-3 一 图 9-6 所 示 。 详 情 界面 包 
括 电影 简介 、 电 影 详情 , 观 影 留言 添加 到 收藏 夹 ,添加 到 观 影 列表 、 评 分 等 。 另 外 ,还 包括 电 
影 预告 片 .演员 及 工作 人 员 信 息 等 。 








m © B = 


故事 发 生 在 多 米 尼克 (TAER Vin Diesel 
t) 和 布 莱 恩 ( 保罗 -沃克 Paul Walker tf ) 重 
获 自由 一 年 多 后 ， 他 们 摆脱 暗 无 天 日 的 亡命 生 
活 ， 却 发 现 这 个 家 脱离 现实 。 多 米 尼克 忙 着 和 
RE OKT B 185182: Michelle Rodriguez... 


` ONN 








76% 
票数 好 
Vengeance Hits Home bis 
详情 
ut © B m 
发 行 日 期 2015 年 4 月 3 日 
故事 发 生 在 多 米 尼克 ( 范 迪 塞 尔 Vin Diesel 时 长 1029 
饰 ) 和 布 莱 恩 ( 保罗 .沃克 Paul Walker th ) 重 
pales Sarre eae 评级 pets 
活 ， 却 发 现 这 个 家 脱离 现实 。 多 米 尼 克 忙 着 和 类 别 动作 , WP, 犯罪, 惊悚 , 爱情 
RE CUT 2 1881821 Michelle Rodriguez. 预算 4$190,000,000 
L 语言 English 
图 9-3 电影 详情 界面 1 图 9-4 电影 详情 界面 2 


Vin Diesel 
Dominic Toretto 


@ Paul Walker ms 正在 观 影 中 


Brian O'Conner 
I'm watching 速度 与 激情 7 
Jason Statham 
Deckard Shaw 


取消 正在 观 影 中 


James Wan 

Director 

Chris Morgan 
B Writer 


图 9-5 电影 详情 界面 3 图 9-6 观 影 留言 界面 











单 击 电影 详情 界面 的 演员 列表 ,显示 演员 详细 信息 界面 ,如 图 9-7 所 示 。 另 外 ,可 以 看 
到 和 演员 相关 的 工作 人 员 信息 。 
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单 击 侧 边栏 中 的 登录 选项 ,显示 如 图 9-8 所 示 的 登录 /注册 界面 。 登 录 成 功 后 ,可 以 在 
侧 边栏 的 “我 的 收藏 夹 ?选项 中 查看 收藏 的 电影 信息 ,包括 已 看 过 和 未 看 过 的 电影 信息 等 ,如 


图 9-9 所 示 。 


€ VinDiesel 


Vin Diesel is an American actor, producer, 
director, and screenwriter. He came to 
prominence in the late 1990s, and first 
became known for appearing in Steven 
Spielberg's Saving Private Ryan in 1998. He i... 


演员 ms 





Guardians of the Galaxy 2 
Groot (voice) 


Inhumans 
Black Bolt (rumored) 





Fast & Furious 8 
Dominic Toretto 








登录 到 trakt.tv 


密码 





© &x O 注册 


BR 





9-7. 演员 详情 界面 


图 9-8 登录 界面 


单 击 侧 边栏 中 的 观看 列表 选项 ,显示 如 图 9-10 所 示 的 界面 ,其 中 包含 了 当前 用 户 的 观 
影 列表 记录 。 单 击 其 中 的 影片 ,显示 如 图 9-1 所 示 的 电影 详情 界面 。 


EL 在 收藏 天 中 











| RB FESE : 圣战 奇兵 (1989) 
4 82% - 7470 票 
CABE 217809: 100258248 


Dallas Buyers Club (2013) 
0%-0 票 
发 行 日 期 ; 2013 年 11 月 22 日 


NE 模仿 游戏 (2014) 
EE] 32% - 6350 R 
M 发 行 日 期 : 2014 年 12 月 19 日 








图 9-9 我 的 收藏 界面 


图 9-10 观看 列表 界面 
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单 击 侧 边栏 中 的 搜索 选项 ,显示 如 图 9-11 所 示 的 搜索 界面 ,在 上 方 的 搜索 关键 词 输入 
框 中 输入 搜索 信息 后 ,在 下 方 显示 相关 电影 和 演员 信息 ,还 可 以 显示 如 图 9-12 所 示 的 相关 
电影 信息 。 





三 Q indiana x 


电影 更 多 


夺 宝 奇兵 3 : 圣战 奇兵 (1989) 
夺 宝 奇兵 2 : 魔域 奇兵 (1984) 
图 FEFA (1981) 


A 更 多 
影 人 发 行 日 期 : 2014 年 11 月 5 日 


Indiana Adams 私刑 教育 (2014) 
74% - 888 票 
发 行 日 期 : 2014 年 9 月 26 日 


图 9-11 搜索 界面 图 9-12 相关 电影 列表 






|: 飓风 营救 3 (2014) 

| Ej 62% -588 m 

| 发 行 日 期 : 2014 年 12 月 16 日 
" 


TUEZ : IABE (2015) 
805-214 $ 
发 行 日 期 ; 2015 年 5 月 15 日 


疾 速 追 杀 (2014) 
71%-818 票 
发 行 日 期 : 2014 年 10 月 24 日 













星际 穿越 (2014) 
84% - 2190 票 








除了 上 面 介绍 的 功能 外 ,应 用 还 提供 了 批 项 目 处 理 、 界 面 刷新 、 系 统 设置 以 及 应 用 信息 
等 功能 。 


9.2 应 用 架构 设计 


通过 9. 1 节 展 示 的 应 用 来 看 , Philm 具有 UI 丰 富 ,交互 事件 多 样 .数据 来 源 不 统一 等 特 
点 。 传 统 的 开发 模式 中 , Activity 与 Model 层 的 关系 非常 紧密 ,许多 UI 层 的 逻辑 事件 都 是 
由 Activity 来 完成 的 ,这 样 的 设计 使 得 Activity 代码 腾 肿 ,可 复 用 性 差 ,不 易 维 护 ,扩展 性 较 
差 等 。 因 此 ,需要 合理 的 应 用 架构 和 设计 模式 来 优化 应 用 设计 。 


9.2.1 MVP 设计 模式 


MVP(Model-View-Presenter) 设 计 模 式 是 MVC 模式 的 衍生 模式 ,主要 目标 是 将 显示 
逻辑 与 业务 逻辑 分 离 , 即 不 容许 View 直接 访问 Model CUI, UI 逻辑 与 业务 逻辑 、 数 据 三 者 
隔离 开 来 ) ,如 图 9-13 所 示 。 

在 Android 中 ,MVP 模式 通常 包含 4 个 要 素 。 

(D View: 负责 绘制 UI 元 素 、 与 用 户 进 行 交互 (Activity 或 Fragment), 

© View Interface; View 需要 实现 的 接口 ,View 通过 View Interface 与 Presenter 进 
ITZE ,降低 耦合 ,方便 进行 单元 测试 。 
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Presenter IE Model 


调用 业务 逻辑 
响应 数据 | | 


中 View Interface 




















View 











图 9-13 MVP 设计 模式 


@ Model: 负责 存储 、 检 索 、 操 纵 数据 (有 时 也 通过 一 个 Model Interface 来 降低 耦合 ) 。 
( Presenter: 从 Model 中 获取 数据 并 提供 给 View 层 ,Presenter 还 负责 处 理 后 台 任 
务 , 承 载 了 大 部 分 的 复杂 逻辑 。 

图 9-13 清晰 地 展示 了 MVP 模式 的 几 个 特点 : 

* View 和 Model 完全 解 耦 ,两 者 不 发 生 直接 关联 ,通过 Presenter 进行 通信 ,便于 维护 
和 测试 。 

。 Presenter 并 不 是 与 具体 的 View 耦合 ,而 是 和 一 个 抽象 的 View Interface HA. AG 
要 在 Presenter 中 为 不 同 的 View 定义 View Interface 即 可 ,具体 的 View 实现 自己 
的 View Interface, 即 可 使 用 Presenter 中 的 Model 操作 等 。 

* View Æ MVP 里 应 该 是 一 个 “ 极 瘦 ” 的 概念 ,最 多 也 只 能 包含 维护 自身 状态 的 逻辑 ， 
而 其 他 逻辑 都 应 实现 在 Presenter 中 。 

1. Philm 总 体 架构 设计 

Philm 使 用 Controller 来 统一 管理 Model 和 View, 该 Controller 相当 于 MVP 中 的 


Presenter, 在 Controller 内 部 ,直接 定义 了 MVP 中 View 与 
Presenter 的 交互 接口 Callback, 另 外 该 项 目 引 入 了 State 的 Çipa) 
概念 ,来 统一 管理 Model 和 业务 中 所 需 的 Event, 所 有 的 人 入 


Activity 和 Fragment 的 跳 转 以 及 TitleBar 和 Drawer 的 管理 Conroe) ( vie ) 
使 用 一 个 Display 来 实现 。 这 些 角色 之 间 的 关系 如 图 9-14 
i Cue Ct) 
下 面 分 析 一 下 MainActivity 的 实现 流程 。 
(1) 初始 化 Controller 和 Display. 图 9-14 MVP 对 象 间 的 关系 
在 Philm 中 ,View 由 Fragment 和 Activity 实现 ,由 于 应 
用 启动 时 首先 启动 Activity, Al JI. 绑 定 Presenter 的 工作 要 在 View 中 进行 (也 就 是 
Activity/Fragment), MainActivity 继承 自 BasePhilmActivity, 在 BasePhilmActivity 的 
onCreate() 方 法 中 初始 化 MainController 和 Display。 核 心 代码 如 下 : 
01 @Override 
02 protected void onCreate(Bundle savedInstanceState) { 


03 
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04 mMainController = PhilmApplication. from(this).getMainController(); 


05 mDisplay 7 new AndroidDisplay(this, mDrawerLayout); 
06 
07 handleIntent(getIntent(), getDisplay()); 


08 ] 


在 onResume() 方 法 中 调用 MainController. init() 方 法 对 所 有 的 Controller 进行 初始 
化 .事件 注册 并 设置 Display。 代 码 如 下 : 


01 @Override 

02 protected void onResume() { 

03 super. onResume( ) ; 

04 mMainController. attachDisplay(mDisplay); 
05 mMainController. setHostCallbacks(this); 
06 mMainController. init(); 

07 +} 


最 后 在 onPause() 中 解除 对 上 述 资源 的 操作 。 

(2) 实现 回调 接口 。 

根据 MVP 的 思想 ,Activity/Fragment 是 一 个 View(UT) ,UI 的 逻辑 由 Controller 通过 
持 有 UI 的 UC 来 处 理 (UC 用 来 响应 UI 的 动作 )。MainActivity 对 应 的 UI 为 
MainController. MainUi, 代 码 如 下 : 


01 public interface MainUi extends MainControllerUi { 
02 void showLoginPrompt( ); 

03 ] 

04 

05 public interface MainControllerUi extends 

06 BaseUiController. Ui <MainControllerUiCallbacks > { 
07 } 

08 

09 public interface Ui «UC» ( 

10 void setCallbacks(UC callbacks); 

11 boolean isModal(); 

i2 f} 


MainUi 总 共有 三 个 方法 : 

* void showLoginPrompt() 

* void setCallbacks(UC callbacks) 

* boolean isModal() 

MainUi 对 应 的 UC 为 MainControllerUiCallbacks , 

(3) $È% UL. 

在 相应 的 Fragment 的 onResume() 方 法 中 调用 attachUi() 方 法 为 Fragment 添加 所 有 
的 Callback 并 进行 视图 的 泻 染 。BaseMovieControllerListFragment 的 onResume() 方 法 代 
码 如 下 : 
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01 @Override 
02 public void onResume() ( 


03 super. onResune( ) ; 
04 getController().attachUi(this); 
ose 


attachUi() 的 实现 在 BaseUiController 中 ,代码 如 下 : 


01 public synchronized final void attachUi(U ui) { 
02 Preconditions.checkArgument(ui != null, "ui cannot be null"); 


03 Preconditions.checkState(!mUis.contains(ui), "UI is already attached"); 
04 

05 mUis.add(ui); 

06 

07 ui. setCallbacks(createUiCallbacks(ui)); 

08 

09 if (isInited()) ( 

10 if (!ui.isModal() && ! (ui instanceof SubUi)) ( 
11 updateDisplayTitle(getUiTitle(ui)); 

12 } 

is 

14 onUiAttached(ui); 

m5 populateUi(ui); 

16 } 

TIE) 


可 以 看 出 ,attachUi() 方 法 通过 ui. setCallbacks(CcreateUiCallbacks Cui) ) 设 置 回调 ,通过 
populateUiCui) 绘 制 UI。 在 MainController 中 ,createUiCallbacks( ui) 的 实现 代码 如 下 : 


01 @Override 
02 protected MainControllerUiCallbacks createUiCallbacks( 


03 final MainControllerUi ui) { 

04 return new MainControllerUiCallbacks() { 

05 @Override 

06 public void onSideMenuItemSelected(SideMenuItem item) { 
07 Display display = getDisplay(); 

08 if (display != null) ( 

09 showUiltem(display, item); 

10 display. closeDrawerLayout(); 

11 } 

12 } 

13 

14 @Override 

I5 public void addAccountRequested() { 

16 Display display = getDisplay(); 

17 if (display != null) { 

18 display. startAddAccountActivity(); 


19 display. closeDrawerLayout(); 
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@Override 
public void showMovieCheckin() { 
Display display = getDisplay(); 
WatchingMovie checkin = mState. getWatchingMovie(); 


if (display != null && checkin != null) { 
display. closeDrawerLayout(); 
display. startMovieDetailActivity(checkin. movie. getIndbId(), 
null); 


} 


@Override 

public void setShownLoginPrompt() { 
mPreferences, setShownTraktLoginPrompt( ); 

} 


Philm 设置 View 回调 采用 了 一 个 非常 精巧 的 设计 : 通过 泛 型 来 处 理 ViewInterface 5 [zl 
调 。BaseUiController 的 泛 型 可 以 表示 为 BaseUiController <ViewInterface, ViewCallbacks>, 
其 中 前 一 个 泛 型 代表 了 用 于 解 耦 View 和 Presenter 而 实现 的 ViewInterface ,而 后 一 个 是 提 
供给 ViewInterface 的 回调 。ViewInterface 本 身 提供 了 setCallbacks 方法 来 进行 
ViewCallbacks 与 View 的 绑 定 。 这 样 , 所 有 的 业务 逻辑 都 可 以 在 Presenter 中 实现 ,之 后 通 
过 回调 提供 给 View, View 仅仅 负责 UI 的 表现 ,在 需要 处 理 业务 逻辑 时 ,通过 调用 之 前 
Presenter 设置 的 回调 实现 。 例 如 , 单 击 网 格 中 的 影片 海报 时 ,一 般 回调 处 理 如 下 : 


01 @Override 
02 public void onListItemClick(GridView l, View v, int position, long id) { 
if (hasCallbacks()) { 


03 
04 
05 
06 
07 
08 
09 
10 
ir 


ListItem <PhilmMovie > item = (ListItem<PhilmMovie>) 1 
. get ItemAtPosition( position) ; 
if (item. getListType() == ListItem.TYPE ITEM) { 
getCallbacks() . showMovieDetail( item. getListItem(), 
ActivityTransitions. scaleUpAnimation(v)); 


Tet LESE. A. State 中 获取 Bean, 如果 没有 启动 子 线程 获取 , 则 发 送 一 个 Event 到 
Controller 进行 视图 更 新 。 例 如 MainController 的 populateUi() 方 法 代码 如 下 : 
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01 private void populateUi(SideMenuUi ui) { 


02 
03 
04 
05 
06 
07 
08 
09 
10 
ipi 
12 
13 
14 
15 
16 
17 
18 


ui. setSideMenuItems(getEnabledSideMenuItems(), 
mState. getSelectedSideMenuIten()); 


PhilmUserProfile profile = mState.getUserProfile(); 
if (profile != null) { 
ui. showUserProfile(profile); 
} else { 
ui. showAddAccountButton(); 
} 


WatchingMovie checkin = mState.getWatchingMovie(); 
if (checkin != null) { 
ui. showMovieCheckin( checkin) ; 
} else { 
ui. hideMovieCheckin( ) ; 
h 


(4) 实现 View. 
MainActivity 的 布局 是 一 个 DrawerLayout, fd MenuFragment(SideMenuFragment) 
和 显示 内 容 的 Fragment。 首 次 展示 的 Fragment 是 通过 BasePhilmActivity 中 handleIntent 
(Intent intent, Display display) 来 确定 的 ,代码 如 下 : 


01 


03 
04 
05 
06 
07 
08 
09 
10 


@Override 
02 protected void handleIntent(Intent intent, Display display) { 


if (Intent. ACTION_MAIN. equals( intent. getAction())) { 
if (!display. hasMainFragment()) { 
getMainController(). setSelectedSideMenuItem( 


MainController.SideMenuItem. DISCOVER) ; 


display.showDiscover(); 


Philm 项目 分 析 与 设计 


在 Philm 项 目 中 ,通过 查看 AndroidDisplay 可 以 知道 ,整个 项 目的 Activity 跳 转 、 
Fragment 切换 .DrawerLayonut 的 开 和 闭 、ActionBar 的 控制 都 是 通过 Display 来 实现 的 。 通 
过 查看 display. showDiscover € ) 可 以 发 现 , Mainactivity 中 的 Fragment 对 应 的 类 为 
DiscoverTabFragment ,其 主要 功能 是 使 用 一 个 ViewPager 管理 几 个 Fragment, 

以 上 MVP 组 件 之 间 的 相互 调用 如 图 9-15 所 示 。 

2. Presenter 5 Display 设计 

Presenter 是 控制 中 心 ,统一 管理 界面 状态 的 初始 化 和 状态 清理 ,为 所 有 的 UI 进行 泻 染 
并 添加 CallBack, 统 一 调度 业务 相关 的 后 台 任 务 线程 ,订阅 State 中 定义 的 Event, 进行 视图 
的 更 新 。Presenter 统一 定义 了 View 与 Presenter 的 View Interface, 一 个 Presenter 可 以 为 
多 个 View 定义 View Interface, 因 此 Presenter 可 以 被 多 个 View 所 共用 。 
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BaseController 
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+mDisplay private Display Display 


+minited private boolean 


*init() 
*oninited() 
+suspend() 
+onSuspended() 
*islnited() 
+setDisplay() 
+getDisplay() 
+handlelntent() 


AndroidDisplay 


























BaseUiController 


+mUis private final Set<U> 
+mUnmodifiableUis private final Set<U> 





+onlnited() BasePhilmActivity 


+attachUi(U ui) +mMainController private MainController 
+detachUi(U ui) 
*onUiAttached(U ui) 
*onUiDetached(U ui) 
*createUiCallbacks(U ui) 
+getUis() 

+populateUlis() 

+updateDisplay Title(String title) 
*getUiTitle(U ui) 
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*mDisplay private Display 
^mDrawerLayout private DrawerLayout 













































































AboutController MovieController UserController 
| +mMoviesState private final MoviesState +mUserState private final UserState 
^ populateUi( AboutUi ui) *ereateUiCallbacks(final MovieUi ui) ereateUiCallbacks(final UserUi ui) 
*getUiTitle(AboutUi ui) *populateUi(final MovieUi ui) spopulateUi( UserUi ui) 
A Base State 
MainController +UiCausedEvent 
= +PaginatedResult 
-+mUserController private final UserController ATA dingProgressEven " 
+mMovie Controller private final MovieController Bante 





+mAboutController private final AboutController 
+mDbHelper private final AsyncDatabaseHelper lectedSideMenultem() 
^ mState private final ApplicationState "getUserProfile() 

+mHostCallbacks private HostCallbacks *getUsername() 
+getCurrentAccount() 

+registerForE vents(Object receiver) 
+unregisterForEvents( Object receiver) 
*Operationl () 





























9-15 MVP 的 类 关系 图 


Philm 的 Presenter 被 设计 成 多 个 Controller, 包 括 AboutController BaseController, 
BaseUiController, MainController , MovieController 和 UserController。 


BaseController 核心 代码 如 下 : 


01 abstract class BaseController { 





02 e 

03 

04 public final void init() { 

05 Preconditions.checkState(mInited false, "Already inited"); 
06 mInited - true; 
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07 onInited(); 

08 } 

09 

10 public final void suspend() { 

TI Preconditions.checkState(mInited -- true, "Not inited"); 
12 onSuspended( ) ; 

13 mInited = false; 

14 } 

15} 


init() 是 所 有 Controller 初始 化 发 起 的 方法 ,例如 ,在 BasePhilmActivity 中 通过 
mMainController. init) 发 起 ,所 有 的 Controller 由 MainCtroller 统一 控制 。suspend() 是 销 
& Controller 的 地 方 。 

BaseUiController 统一 定义 管理 某 个 界面 的 所 有 的 UI 事件 和 接口 ,核心 代码 如 下 : 


01 abstract class BaseUiController <U extends BaseUiController.Ui<UC>, UC» 


02 extends BaseController ( 

03 cu 

04 public interface Ui «UC» ( 

05 void setCallbacks(UC callbacks); 

06 boolean isModal(); 

07 } 

08 

09 @Inject Logger mLogger; 

10 private final Set <U> nUis; 

11 private final Set <U> mUnmodifiableUis; 

12 

13 public BaseUiController() { 

14 mUis = new CopyOnWriteArraySet <>( ) ; 

15 mUnmodifiableUis = Collections. unmodifiableSet(mUis) ; 
16 } 

LT 

18 public synchronized final void attachUi(U ui) { 

19 Preconditions.checkArgument(ui != null, "ui cannot be null"); 
20 Preconditions.checkState(!mUis.contains(ui), 
21 "UI is already attached"); 

22 mUis.add(ui); 

23 ui. setCallbacks(createUiCallbacks(ui)); 

24 

25 if (isInited()) { 

26 if (!ui.isModal() && ! (ui instanceof SubUi)) ( 
2T updateDisplayTitle(getUiTitle(ui)); 
28 } 

29 

30 onUiAttached( ui); 

31 populateUi(ui); 

32 } 

33 } 
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protected final void updateDisplayTitle(String title) { 
Display display 7 getDisplay(); 
if (display != null) { 
display. setActionBarTitle(title) ; 


public synchronized final void detachUi(U ui) { 
Preconditions. checkArgument(ui != null, "ui cannot be null"); 
Preconditions. checkState(mUis.contains(ui), "ui is not attached"); 
onUiDetached( ui) ; 
ui. setCallbacks(null); 


mUis. remove(ui) ; 


protected void onInited() { 
if (!mUis. isEmpty()) { 
for (U ui : mUis) { 
onUiAttached(ui) ; 
populateUi( ui) ; 


protected synchronized final void populateUis() { 
if (Constants. DEBUG) { 
mLogger. d(getClass().getSimpleName(), "populateUis"); 
} 
for (Uui : mUis) ( 
populateUi(ui); 


protected synchronized U findUi(final int id) { 
for (U ui : mUis) { 
if (getId(ui) == id) { 
return ui; 


j} 


return null; 


protected final void populateUiFromEvent( 
BaseState. UiCausedEvent event) { 
Preconditions. checkNotNull(event, "event cannot be null"); 


final Uui = findUi(event.callingId); 
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83 if (ui != null) ( 
84 populateUi(ui); 
85 } 

86 } 

87 

88 ] 


每 个 Controller 都 拥有 一 个 自己 的 UiCallBacks, 以 及 一 个 继承 自 BaseUiController. Ui 
的 UI。 

在 Controller 内 部 也 可 同时 为 不 同 的 View 定义 相应 的 UICallBack ,因为 不 同 的 View 
可 能 会 使 用 到 相同 的 Model State 等 事件 ,不 同 的 View 只 需 实现 Controller 中 定义 的 与 自 
己 相 关 的 CallBack 即 可 。 当 然 该 UICallBack 需要 继承 已 实现 BaseUiController. Ui 的 UI, 
因为 最 终 都 会 传人 BaseUIController 中 进行 setCallbacks(UC)。 

04—07 fili] UICUC 4 H EFA Controller 的 子 类 所 在 UI 都 需要 实现 的 UI 接口 ， 
拥有 CallBack 的 能 力 , 在 Controller 调用 attachUi() 时 会 为 传人 的 UI 设置 CallBack, 

10 行 的 mUis 用 于 存储 所 有 的 UI, 11 行 的 mUnmodifiableUis 是 mUis 的 复制 ,但 不 
可 修改 。 

18~33 行 的 attachUi(U ui) 方 法 在 Activity 或 者 Fragment 的 onResume() 中 调用 , 进 
行 添加 回调 、 视 图 泻 染 等 工作 。 该 方法 是 final 类 型 ,不 可 复写 ,只 是 为 了 Controller 的 实现 
类 进行 状态 的 管理 ,如 果 需 要 更 多 的 操作 ,可 以 实现 onUiAttached(UI) 方 法 ,该 方法 会 在 
attachUI 中 调用 。 

51~58 行 的 onInited() 方 法 在 各 个 Controller 进行 初始 化 时 调用 ,不 用 明确 地 调用 , 因 
为 MainController 统一 管理 了 所 有 的 Controller, 例 如 ,在 BasePhilmActivity 的 onResume() 
中 通过 调用 MainController. init() 方 法 统一 初始 化 。 

78~86 行 的 populateUiFromEvent(BaseState. UiCausedEvent event) 方 法 在 某 些 数据 
更 新 ,需要 更 新 视图 时 调用 该 方法 ,发 送 一 个 事件 ,通知 Controller 进行 UI 更新。 

Display 是 Philm 中 一 处 比较 新 颖 的 设计 , 它 本 身 应 该 算是 Presenter 的 一 部 分 ,具体 的 
实现 在 AndroidDisplay 类 中 。AndroidDisplay 的 作用 是 负责 应 用 中 所 有 UI 切换 的 工作 ， 
比如 Activity 跳 转 、 现 实 Fragment、 弹 出 Drawer 等 。AndroidDisplay 内 部 没有 业务 逻辑 操 
作 。AndroidDisplay 核心 代码 如 下 : 


01 public class AndroidDisplay implements Display { 


02 sss 

03 public AndroidDisplay(ActionBarActivity activity, 

04 DrawerLayout drawerLayout) ( 

05 mActivity = Preconditions. checkNotNull(activity, 
06 "activity cannot be null"); 

07 mDrawerLayout - drawerLayout; 

08 

09 mActivity.getTheme(). resolveAttribute(R.attr.colorPrimaryDark, 
10 sTypedValue, true); 

让 mColorPrimaryDark = sTypedValue. data; 

12 
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13 if (mDrawerLayout != null) { 

14 mDrawerLayout. setStatusBarBackgroundColor(mColorPrimaryDark) ; 
15 } 

16 } 

1T 


18 @Override 

19 public void showLibrary() { 

20 ShowFragmentFromDrawer(new LibraryMoviesFragment() ) ; 

21 } 

22 

23 @Override 

24 public void startMovieDetailActivity(String movieId, Bundle bundle) { 


25 Intent intent - new Intent(mActivity, MovieActivity.class); 
26 intent. putExtra(PARAM ID, movield) ; 

27 startActivity(intent, bundle); 

28 } 

29 

30 


St @Overr ide 
32 public void closeDrawerLayout() { 


33 if (mDrawerLayout != null && 

34 mDrawerLayout. isDrawerOpen(GravityCompat. START)) { 
35 mDrawerLayout. closeDrawers(); 

36 } 

37 } 

seg 


在 BasePhilmActivity 中 调用 mDisplay = new AndroidDisplay(this, mDrawerLayout) 97] 4f 
化 Display ,然后 在 MainController 中 调用 showUiItem() 等 方法 控制 UI 的 显示 。 

3. Model 与 State 设计 

Philm 中 的 Model 通过 State 来 管理 ,State 保存 界面 使 用 到 了 业务 Bean ,定义 业务 中 
用 到 了 Event 事件 ,包括 异步 请 求 完成 的 通知 ,数据 变更 .NetWork 的 状态 变化 、 
LoadingProgress 的 展示 与 隐藏 等 。 注 意 ,State 并 不 对 Model 做 复杂 的 操作 ,只 是 简单 的 
Set 和 Get 操作 ,复杂 的 操作 全 部 由 Controller 处 理 。 

每 一 个 界面 都 拥有 自己 的 State 接口 ,ApplicationState 负责 统一 实现 所 有 State HO, 
是 一 个 包含 了 所 有 Model 总 和 的 类 ,扮演 了 Ul 和 后 台 线程 的 通信 者 ,实现 保存 业务 Bean 
的 分 发 和 事件 的 分 发 。ApplicationState 核心 代码 如 下 : 


01 public final class ApplicationState implements BaseState, 


02 MoviesState, UserState { 

03 

04 

05 public ApplicationState(Bus eventBus) { 

06 mEventBus = Preconditions. checkNotNull(eventBus, 

07 "eventBus cannot null"); 

08 mTmdbIdMovies = new ArrayMap <>( INITIAL MOVIE MAP CAPACITY); 
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09 mImdbIdMovies = new ArrayMap <>(INITIAL MOVIE MAP CAPACITY); 
10 mPeople = new ArrayMap <>(); 

1 } 

12 

13 @Override 

14 public void registerForEvents(Object receiver) { 

15 mEventBus. register(receiver); 

16 } 


18 @Override 

79; public Map < String, PhilmMovie getTmdbIdMovies() { 
20 return mTmdbIdMovies; 

21 } 


23 @Overr ide 
24 public void setLibrary(List <PhilmMovie> items) { 


25 if (!Objects. equal(items, mLibrary)) { 

26 mLibrary = items; 

27 mEventBus. post(new LibraryChangedEvent()); 
28 ) 

29 } 

30 } 


在 使 用 Controller 进行 界面 泻 染 时 ,首先 从 State 中 获取 业务 Bean, An State 中 没 
有 ,Controller 则 会 启动 后 台 线程 请 求 数据 ,成 功 获取 数据 后 通过 state. set() 分 发 保存 到 
State 中 ,同时 会 发 出 一 个 Event 通知 Controller 进行 相应 的 处 理 。 


9.2.2 Dagger 与 依赖 注入 


1. 依赖 注入 
依赖 注入 (Dependency Injection) 又 称 控制 反 转 (Inversion of Control) ,是 一 种 软件 设 
计 模 式 ,其 基本 思想 是 : 用 一 个 单独 的 对 象 获得 接口 的 一 个 合适 的 实现 ,并 将 其 实例 赋 给 调 
用 者 的 一 个 字段 。 当 某 个 角色 (可 能 是 一 个 Java 实例 ,调用 者 ) 需 要 另 一 个 角色 ( 另 一 个 
Java 实例 ,被 调用 者 ) 的 协助 时 ,在 传统 的 程序 设计 过 程 中 ,通常 由 调用 者 来 创建 被 调用 者 
的 实例 。 如 果 创 建 被 调用 者 实例 的 工作 不 再 由 调用 者 来 完成 ,而 是 由 外 部 容器 完成 , 则 称 为 
控制 反 转 。 创 建 被 调用 者 实例 的 工作 通常 由 外 部 容器 来 完成 ,然后 注入 调用 者 ,因此 也 称 为 
依赖 注入 。 
依赖 注入 涉 及 多 个 元 素 : 
。 调用 者 (依赖 者 ); 
。 一 份 依赖 的 声明 ,以 接口 方式 定义 ; 
。 一 个 注入 器 (有 时 也 叫 提供 者 、 容 器 ) , 它 能 创建 实现 了 接口 (定义 依赖 的 接口 ) 的 类 
的 实例 。 
调用 者 会 描述 它 需 要 哪些 被 调用 者 才能 正常 工作 。 再 由 注入 容器 来 决定 哪些 具体 的 实 
现 能 满足 调用 者 的 需求 ,并 提供 给 调用 者 。 
在 传统 的 软件 开发 中 ,调用 者 需要 自己 来 确定 被 调用 的 对 象 。 但 是 在 依赖 注入 模式 中 ， 
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这 个 决定 权 授权 给 了 注入 容器 ,注入 容器 能 在 软件 运行 时 选择 替换 不 同 的 实现 ,而 不 是 在 编 
译 时 。 这 也 是 依赖 注入 的 关键 优势 。 

依赖 注 人 有 三 种 典型 的 方式 。 

C1) 构造 器 注入 (Constructor Injection): 注入 容器 会 智能 地 选择 和 调用 适合 的 构造 方 
法 以 创建 依赖 的 对 象 。 如 果 被 选择 的 构造 方法 具有 相应 的 参数 ,注入 容器 在 调用 构造 方法 
之 前 解析 注册 的 依赖 关系 并 自行 获得 相应 参数 对 象 。 

(2) 属性 注入 (Property Injection): 如 果 需 要 使 用 到 被 依赖 对 象 的 某 个 属性 ,在 创建 被 
依赖 对 象 之 后 ,注入 容器 会 自动 初始 化 该 属性 。 

(3) 方法 注入 (Method Injection); 如 果 被 依赖 对 象 需要 调用 某 个 方法 进行 相应 的 初始 
化 ,在 该 对 象 创建 之 后 ,注入 容器 会 自动 调用 该 方法 。 



































2. Dagger? 框架 容器 (ObjectGrapm) 
Dagger 是 由 专注 于 移动 支付 的 公 | App ee 存放 通过 @Inject、 
司 一 一 Square 公司 推出 的 一 种 Android 平 "|@Provider 注 解 的 类 
台 的 依赖 注入 框架 。Dagger 构建 在 标准 的 
javax. inject Annotation 基础 之 上 ,使 用 Modules 


Annotation 给 需要 注入 的 对 象 做 标记 , 通 


过 inject() 方 法 自动 注 和 人 所 有 对 象 ,从 而 完 Module) CModule2) 
成 自动 的 初始 化 。Dagger 的 框架 如 图 9-16 
所 示 。 图 9-16 MVP 设计 模式 

Dagger 使 用 的 基本 步骤 如 下 。 

CD 在 相关 类 的 构造 方法 前 添加 一 个 @Inject 注解 ,Dagger 就 会 在 需要 获取 该 对 象 时 ， 
调用 这 个 被 标记 的 构造 方法 ,从 而 生成 一 个 对 象 实例 。 例 如 : 


01 public class MusicBean { 
02 


04 @Inject 
05 public MusicBean() { 


07 } 


30. 3} 


注意 : 如 果 构 造 方法 含有 参数 ,Dagger 会 在 调用 构造 对 象 时 先 去 获取 这 些 参数 ,所 以 
要 保证 它 的 参数 也 提供 可 被 Dagger 调用 到 的 生成 方法 。Dagger 可 调用 的 对 象 生成 方式 有 
两 种 : 一 种 是 用 @Inject 修饰 的 构造 方法 ,上 面 就 是 这 种 方式 。 另 外 一 种 是 用 @Provides 修 
饰 的 方法 。 

(2) 在 Activity 中 注入 类 实例 。 具 体 方法 是 在 Activity 中 的 MusicBean 属性 声明 之 前 


© Dagger E Rd: http://square. github. io/dagger/. 
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添加 @Inject 注解 ,这样 Dagger 就 知道 哪些 属性 需要 被 注入 ,然后 调用 通过 @Inject 注解 的 
构造 方法 。 例 如 : 


01 public class MainActivity extends Activity { 
02 @Inject MusicBean musicBean; 

03 

04 } 


对 构造 方法 进行 注解 是 很 好 的 实现 依赖 的 途径 ,然而 它 并 不 适用 于 所 有 情况 。 

。 接口 没有 构造 方法 ,不 能 被 构造 。 

。 第 三 方 的 类 不 能 被 注释 构造 。 

。 有 些 类 需要 灵活 选择 初始 化 的 配置 ,而 不 是 使 用 一 个 单一 的 构造 方法 。 

(3) 在 Activity 的 合适 位 置 ( 一 般 在 onCreate() 生 命 周期 回调 方法 中 ) 调 用 
ObjectGraph. inject() 方 法 ,Dagger 就 会 自动 调用 步骤 (1) 中 的 生成 方法 生成 依赖 的 实例 ， 
并 注入 当前 对 象 中 (如 MainActivity) 。 


01 public class MainActivity extends Activity { 

02 @Inject MusicBean musicBean; 

03 

04 @Override 

05 protected void onCreate(Bundle savedInstanceState) { 
06 ObjectGraph. create(AppModule. class). inject(this) ; 
07 } 

08 

09 ] 


XX FÉ , Android 开发 工具 apt 会 在 MainActivity 所 在 的 package 下 生成 一 个 辅助 类 
MainActivity $ $ Inject Adapter ,并 在 该 类 中 实现 injectMembers() 方 法 ,代码 类 似 如 下 : 


01 public void injectMembers(MainActivity paramMainActivity) { 

02 paramMainActivity.musicBean - ((MusicBean)musicBean.get()); 
03 

04 } 


上 面 通过 ObjectGraph. inject O Fy i£ f£ A paramMainActivity. Jf. H. musicBean 属性 是 
package 权限 ,所 以 Dagger 只 需要 调用 这 个 辅助 类 的 injectMembers() 方 法 即 可 完成 依赖 
注入 ,这 里 的 musicBean. get() 会 调用 MusicBean 的 生成 方法 。 

至 此 ,就 完成 了 使 用 Dagger 的 @Inject 方 式 将 一 个 MusicBean 对 象 注 入 MainActivity 
的 流程 。 

3. Philm 中 的 依赖 注入 

在 Philm 项 目 中 ,复杂 的 用 户 界面 和 事件 逻辑 需要 多 处 获取 账户 信息 、 网 络 状 态 等 ,如 
果 在 每 次 使 用 这 些 对 象 时 都 通过 new 方法 来 获取 ,将 使 代码 的 耦合 度 非 常 高 ,给 后 期 的 维 
护 带 来 很 大 的 麻烦 。 下 面 结合 Philm 项 目 , 具 体 分 析 使 用 Dagger 实现 依赖 注入 模式 来 解 耦 
合 代码 ,各 层 对 象 的 调用 完全 面向 接口 ,这 样 , 当 系 统 重 构 时 ,代码 的 改写 量 将 大 大 减少 。 
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下 面 是 账户 管理 的 依赖 注入 过 程 。 
CD 定义 账户 管理 接口 ,代码 如 下 : 


01 public interface PhilmAccountManager { 


02 
03 
04 
05 
06 


public List <PhilmAccount > getAccounts(); 

public void addAccount (PhilmAccount account); 
public void removeAccount (PhilmAccount account); 
public void updatePassword( PhilmAccount account); 


(2) 实现 账户 管理 接口 ,核心 代码 如 下 : 


01 public class AndroidAccountManager implements PhilmAccountManager { 


02 
03 
04 
05 
06 
07 
08 
09 
10 
hi 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 


private final AccountManager mAccountManager; 


public AndroidAccountManager( AccountManager accountManager) { 
mAccountManager = Preconditions. checkNotNull(accountManager, 
"accountManager cannot be null"); 


@Override 
public List <PhilmAccount > getAccounts() { 
final Account[] accounts = mAccountManager 
. getAccountsByType(Constants. TRAKT ACCOUNT TYPE); 
ArrayList < PhilmAccount > philmAccounts = new 
ArrayList <>( accounts. length); 


for (int i = 0; i< accounts. length ; i++) { 
final Account account = accounts[i]; 


String password = mAccountManager. getPassword( account) ; 


philmAccounts. add(new PhilmAccount(account. name, password) ) ; 


return philmAccounts; 


@Override 
public void addAccount(PhilmAccount philmAccount) { 


@Override 
public void removeAccount(PhilmAccount philmAccount) { 
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@Override 
public void updatePassword(PhilmAccount philmAccount) { 


h 


(3) 实现 依赖 关系 ,代码 如 下 : 


01 @Module( 

02 includes - ContextProvider.class, 

03 library = true 

04 ) 

05 public class AccountsProvider ( 

06 

07 @Provides @Singleton 

08 public PhilmAccountManager provideAccountManager( AccountManager 
09 androidAccountManager) ( 

10 return new AndroidAccountManager (androidAccountManager) ; 
11 } 

12 

ve 

说 明 : 


一 个 Module 中 所 有 @Provides 方法 的 参数 都 必须 在 这 个 Module 中 提供 相应 的 
(à Provides 方法 ,或 者 在 @Module 注解 后 添加 “complete = false”, 注 明 这 是 一 个 
不 完整 Module( 即 它 会 被 其 他 Module 所 扩展 ) 。 

一 个 Module 中 所 有 的 @Provides 方法 都 要 被 它 声明 的 注入 对 象 所 使 用 ,或 者 在 
(à Module 注解 后 添加 “library = ture” 注 明 ( 即 它 是 为 了 扩展 其 他 Module 而 存在 
的 )。 

通常 情况 下 ,约定 @Provides 方法 以 provide 作为 前 级 ,@Module 类 以 Module 作为 
后 缓 。 

所 有 带 有 @Provides 注解 的 方法 都 需要 被 封装 到 带 有 @Module 注解 的 类 中 。 
@Singleton 是 一 种 单 例 注解 ,通过 添加 @Singleton 注解 之 后 ,对 象 只 会 被 初始 化 一 
次 ,之 后 的 每 次 都 会 被 直接 注入 相同 的 对 象 。 


(4) 构建 全 局 依赖 关系 ,代码 如 下 : 


01 
02 
03 
04 
05 
06 
07 
08 


@Module( 

injects = PhilmApplication.class, 

includes = { 
UtilProvider. class, 
AccountsProvider. class, 
NetworkProvider. class, 
StateProvider. class, 
PersistenceProvider. class, 
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09 
10 
TI 
12 
T3 


InjectorModule. class 


) 
public class ApplicationModule { 


} 


(5) 构建 ObjectGraph。ObjectGraph 是 由 Dagger 提供 的 抽象 工具 类 ,负责 Dagger 所 
有 的 业务 逻辑 ,Dagger 最 关键 流程 都 是 从 这 个 类 发 起 的 ,包括 依赖 关系 图 创建 ,实例 (依赖 
或 宿主 ) 获 取 、 依 赖 注入 。 上 一 步 的 PhilmApplication 代码 如 下 : 


01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
ZI 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
St. 
32 
33 
34 
35 
36 
37 
38 


public class PhilmApplication extends Application implements Injector { 


public static PhilmApplication from(Context context) { 
return (PhilmApplication) context. getApplicationContext(); 


@Inject MainController mMainController; 
private ObjectGraph mObjectGraph; 


@Override 
public void onCreate() { 
super. onCreate() ; 


if (AndroidConstants.STRICT MODE) { 

StrictMode. setThreadPolicy(new StrictMode. ThreadPolicy.Builder() 
.detectAll() 
. penaltyLog() 
. penaltyDialog() 
. build()); 

StrictMode. setVmPolicy(new StrictMode. VmPolicy. Builder() 
. detectAll() 
. penaltyDeath() 
. penaltyLog() 
. build()); 


mObjectGraph = ObjectGraph. create( 
new ContextProvider(this), 
new ApplicationModule(), 
new ViewUtilProvider(), 
new TaskProvider(), 
new InjectorModule(this), 
new ReceiverProvider( ) 


); 


mObjectGraph. inject(this) ; 





39 

40 public MainController getMainController() { 
41 return mMainController; 

42 } 

43 

44 public ObjectGraph getObjectGraph() { 
45 return mObjectGraph; 

46 } 

47 

48 @Override 

49 public void inject(Object object) { 
50 mObjectGraph. inject( object) ; 

5L } 

s2 } 


34 @Inject #il@ Provides 注解 的 类 构建 了 一 个 对 象 之 间 相 互 依赖 的 图 表 关 联 时 ,通过 
ObjectGraph. create() 方 法 获取 这 个 对 象 图 表 , 其 中 参数 为 所 有 的 Module. 

ObjectGraph 的 主要 方法 如 下 。 

* create(Object... modules): 这 是 个 静态 的 构造 方法 ,用 于 返回 一 个 ObjectGraph 的 实 
例 , 是 使 用 Dagger 调用 的 第 一 个 方法 。 参 数 为 ModuleClass 对 象 ,方法 的 作用 是 根据 
ModuleClass 构建 一 个 依赖 关系 图 。 此 方法 的 实现 会 直接 调用 DaggerObjectGraph. 
makeGraph(null, new FailoverLoader()，modules) 返 回 一 个 DaggerObjectGraph 
对 象 。 

* inject(T instance) : 抽象 方法 ,表示 向 某 个 Host 对 象 中 注入 依赖 。 

injectStatics() : 抽象 方法 ,表示 向 ObjectGraph 中 相关 的 Host 注入 静态 属性 。 

* get(Class type): 抽象 方法 ,表示 得 到 某 个 对 象 的 实例 ,多 用 于 得 到 依赖 的 实例 。 

* plus(Object... modules): 抽象 方法 ,表示 返回 一 个 新 的 包含 当前 ObjectGraph 中 所 
有 Binding 的 ObjectGraph 。 

* validateO : 抽象 方法 ,表示 对 当前 的 ObjectGraph 做 检查 。 

(6) 延迟 注入 。 

某 些 情况 下 需要 延迟 初始 化 一 个 对 象 。 对 任意 的 对 象 工 来 说 ,可 以 使 用 Lazy 实现 延 
BM ite. Lazy 只 有 当 调 用 Lazy 的 get() 方 法 时 , 才 会 初始 化 TMA. WR 工 是 一 个 单 
独 的 对 象 ,Lazy 也 将 使 用 同一 个 对 象 进行 注 和 操作。 否则 ,每 次 注入 都 将 生成 自己 的 Lazy 
对 象 。 当 然 ,任何 随后 调用 Lazy. get( ) 方 法 的 操作 将 返回 之 前 构建 好 的 工 对 象 。 

例如 ,在 BaseMovieRunnable 中 延迟 注入 的 实现 代码 如 下 : 


01 public abstract class BaseMovieRunnable <R> extends NetworkCallRunnable <R> { 
02 

03 m 

04 @Inject Lazy < Tndb > mLazyTmdbClient; 

05 @Inject Lazy < Trakt > mLazyTraktClient; 

06 @lInject Lazy < AsyncDatabaseHelper > mDbHelper; 

07 @Inject Lazy < TraktMovieEntityMapper > nLazyTraktMovieEntityMapper; 
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08 @Inject Lazy < TndbMovi eEnt ityMapper > mLazyTmdbMovieEntityMapper; 
09 @Inject Lazy « TndbCastEntityMapper > nLazyTmdbCastEntityMapper; 

10 @Inject Lazy < TndbCrewEntityMapper > mLazyTmdbCrewEntityMapper; 

11 @Inject Lazy < TndbPersonEntityMapper > nLazyTmdbPersonEntityMapper; 


12 @Inject Lazy < Bus > mEventBus; 

13 @ Inject Lazy < CountryProvider > mCountryProvider; 
14 

15 public BaseMovieRunnable(int callingId) { 

16 mCallingId = callingId; 

17 } 

18 } 


9.3 网络 接口 设计 与 数据 解析 


Philm 使 用 Square Inc. 提供 的 OkHttp、Retrofit 与 GSON 简单 ,快速 地 集成 REST 
API, 为 项 目的 网 络 功能 实现 提供 了 和 良好 的 设计 模式 。 


9.3.1 网 络 接口 设计 


本 节 以 获取 图 9-1 所 显示 的 当前 流行 电影 信息 为 例 ,分析 基于 MVP 设计 模式 和 REST 
软件 架构 风格 的 网 络 接口 设计 。 

1. MVP 框架 流程 

PopularMoviesFragment 继承 自 BaseMovieControllerListFragment( 具 体 的 类 层次 关 
系 参 见 9. 4. 3 小 节 ) , 当 该 Fragment 被 泻 染 时 会 调用 到 BaseMovieControllerListFragment 
的 onResume() 方 法 ,在 onResume() 方 法 中 会 继续 调用 MovieController 的 attachUi() 方 法 
(由 于 MovieController 继承 自 BaseUiController, 本 质 上 调用 的 是 BaseUiController 的 
attachUi() 方 法 ,具体 代码 参见 9.2. 1 小 节 ) 。 

在 attachUiO 方法 中 调用 onUiAttached Cui) 方法 和 populateUi Cui) 方法 。 
onUiAttached() 方 法 在 MovieController 中 进行 了 重新 实现 ,核心 代码 如 下 : 


01 @Override 
02 protected void onUiAttached(final MovieUi ui) { 
03 final MovieQueryType queryType - ui.getMovieQueryType(); 


04 
05 if (queryType.requireLogin() && ! isLoggedIn()) { 
06 return; 

07 ) 

08 


09 String title - null; 
10 String subtitle = null; 


12 final int callingId = getId(ui); 
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14 switch (queryType) ( 


15 case TRENDING: 

16 fetchTrendingIfNeeded(callingId); 

17 break; 

18 case POPULAR: 

19 fetchPopularIfNeeded(callingId); 

20 break; 

21 

22 } 

23 

24 final Display display = getDisplay(); 

25) if (display != null) { 

26 if (!ui. isModal()) { 

27 display.showUpNavigation(queryType != null && 
28 queryType. showUpNavigation()); 

29 display. setColorScheme(getColorSchemeForUi(ui) ) ; 
30 } 

ai display. setActionBarSubtitle(subtitle); 

32 } 

3373 


在 PopularMoviesFragment 中 , getMovieQueryType O 7j %& iE t. MovieController 的 
MovieQueryType 为 POPULAR ,因此 ,在 POPULAR 分 支 调用 fetchPopularIf Needed O 77 
法 ,代码 如 下 : 


01 private void fetchPopularIfNeeded(final int callingId) { 

02 MoviesState.MoviePaginatedResult popular = mMoviesState. getPopular(); 
03 if (popular == null || PhilmCollections. isEmpty(popular. items)) ( 

04 fetchPopular(callingId, TMDB FIRST PAGE); 

05 } 

06 ] 


如 果 mMoviesState 中 popular 数据 为 空 ,将 会 执行 featchPopular() 方 法 ,代码 如 下 : 
01 private void fetchPopular(final int callingId，final int page) { 


02 executeTask(new FetchTmdbPopularRunnable(callingId, page)); 
(ae) th 


其 中 ,executeTask() 方 法 的 代码 如 下 : 


01 private <R> void executeTask(BaseMovieRunnable<R> task) { 


02 mInjector. inject(task) ; 
03 mExecutor. execute(task) ; 
04 ] 


mExecutor 是 在 创建 MovieController 对 象 时 注入 的 ,本 质 上 这 个 对 象 是 在 app. philm. 
in. modules. library. UtilProvider 中 提供 的 ,代码 如 下 : 
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01 @Provides @Singleton @GeneralPurpose 
02 public BackgroundExecutor provideMultiThreadExecutor() { 


03 final int numberCores = Runtime. getRuntime().availableProcessors( ) ; 
04 return new PhilmBackgroundExecutor( 

05 Executors.newFixedThreadPool(numberCores * 2 + 1)); 

06 ] 


所 以 调用 MovieController 的 executeTaskO 77 iE HY mExecutor. execute(task) ,本质 
上 是 调用 PhilmBackgroundExecutor 的 execute() 方 法 ,代码 如 下 : 


01 @Override 

02 public <R> void execute(NetworkCallRunnable < R> runnable) ( 

03 mExecutorService. execute(new TraktNetworkRunner <>(runnable) ) ; 
04 } 


可 以 看 到 FetchTmdbPopularRunnable 对 象 被 传人 TraktNetworkRunner ,其 中 的 run OO 
方法 代码 如 下 : 
01 @Override 


02 public final void run() { 
03 android. os. Process. setThreadPriority( 


04 Process. THREAD PRIORITY BACKGROUND); 

05 

06 sHandler. post(new Runnable() { 

07 @Override 

08 public void run() { 

09 mBackgroundRunnable. onPreTraktCall(); 

10 } 

11 Dp; 

12 

13 R result = null; 

14 RetrofitError retrofitError = null; 

15 

16 try { 

17 result = mBackgroundRunnable. doBackgroundCall(); 

18 } catch (RetrofitError re) { 

19 retrofitError = re; 

20 if (Constants. DEBUG) { 

2T Log. d(( (Object) this).getClass().getSimpleName(), 
22 "Error while completing network call", re); 
23 } 

24 i 

25 

26 sHandler. post(new ResultCallback(result, retrofitError)); 
NT 


其 中 ,17 行 调 用 的 doBackgroundCall() 方 法 是 FetchTmdbPopularRunnable 提供 的 , 代 
码 如 下 : 
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01 @Override 
02 public MovieResultsPage doBackgroundCall() throws RetrofitError { 


03 return getTmdbClient(). moviesService().popular( 

04 getPage(), 

05 getCountryProvider().getTwoLetterLanguageCode()); 
06 ] 


03 行 的 getTmdbClient() 方 法 返回 一 个 PhilmTmdb 对 象 。 在 NetworkProvider 中 ， 
provideTmdbClient() 方 法 的 代码 如 下 : 


01 @Provides @Singleton 

02 public Tmdb provideTmdbClient(@CacheDirectory File cacheLocation) { 
03 Tmdb tmdb = new PhilmTmdb(cacheLocation) ; 

04 tmdb.setApiKey(Constants. TMDB API KEY); 

05 tmdb. setIsDebug(Constants.DEBUG NETWORK); 

06 return tmdb; 

07 +} 


这 是 一 种 通过 多 态 的 原理 实现 的 单 实例 模式 。 获 取 的 PhilmTmdb 的 moviesService() 
方法 代码 如 下 : 


01 public MoviesService moviesService() ( 
02 return (MoviesService)this.getRestAdapter().create(MoviesService. class); 
ie y 


这 里 的 getRestAdapterO fll MoviesService 非常 重要 ,下 面 将 分 别 介绍 。 
2. 基于 OkHttp 网 络 连接 
OkHttp® 是 一 个 高 效 的 HTTP 库 , 具 有 以 下 特点 : 
* 支持 SPDY(Google 开发 的 基于 TCP 的 应 用 层 协 议 ,用 于 最 小 化 网 络 延迟 ,提升 网 
络 速 度 ,优化 用 户 的 网 络 使 用 体验 ) ,共享 同一 个 Socket 来 处 理 同一 个 服务 器 的 所 
有 请 求 。 
* 如 果 SPDY 不 可 用 , 则 通过 连接 池 来 减少 请 求 延 时 。 
。 无 颖 地 支持 GZIP 来 减少 数据 流量 。 
。 缓存 响应 数据 来 减少 重复 的 网 络 请 求 。 
下 面 分 析 一 下 前 面 所 述 的 moviesService() 方 法 中 的 getRestAdapter() 在 OkHttp 方面 
的 应 用 。getRestAdapter() 代 码 如 下 : 


01 protected RestAdapter getRestAdapter() { 
02 if(this.restAdapter == null) { 


03 Builder builder = this.newRestAdapterBuilder(); 
04 builder. setEndpoint("https://api. themoviedb. org/3") ; 
05 builder. setConverter(new GsonConverter( 


© OkHttp 官网 : http://square. github. io/okhttp/ 。 
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06 
07 
08 
09 
10 
1r 
12 
T3 
14 
15 
16 
17 
18 
19 
20 


TndbHelper. getGsonBuilder().create())); 
builder. setRequestInterceptor(new RequestInterceptor() { 
public void intercept(RequestFacade requestFacade) { 
requestFacade. addQueryParam("api key", Tmdb. this. apiKey) ; 


D; 


if(this. isDebug) ( 
builder. setLogLevel(LogLevel. FULL); 


this.restAdapter = builder. build(); 


return this. restAdapter; 


其 中 03 行 的 newRestAdapterBuilder( ) Æ Tmdb 的 PhilmTmdb 子 类 中 的 实现 代码 
AVR: 


01 


@Override 


02 protected RestAdapter. Builder newRestAdapterBuilder() { 


03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 
16 
dg 
18 
19 
20 
21 
22 
23 
24 
25 
26 


RestAdapter.Builder b = super.newRestAdapterBuilder(); 


if (mCacheLocation != null) { 


OkHttpClient client - new OkHttpClient(); 


try { 
File cacheDir = new File(mCacheLocation, 
UUID. randomUUID(). toString()) ; 
Cache cache = new Cache(cacheDir, 1024); 
client. setCache(cache) ; 
) catch (IOException e) { 
Log. e(TAG, "Could not use OkHttp Cache", e); 


client. setConnectTimeout(Constants. CONNECT TIMEOUT MILLIS, 
TimeUnit. MILLISECONDS) ; 

client. setReadTimeout(Constants. READ TIMEOUT MILLIS, 
TimeUnit. MILLISECONDS) ; 


b. setClient(new OkClient(client)); 


return b; 


06 行 的 OkHttpClient Jj HTTP Client 配置 包括 代理 设置 .超时 设置 .缓存 设置 等 参 
3. OkHttp 官方 文档 并 不 建议 创建 多 个 OkHttpClient, 如果 需 要 ,可 以 使 用 clone() 方 法 
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创建 一 个 对 象 副 本 ,再 进行 自 定义 。 

3. 基于 Retrofit 的 REST 接口 封装 

Retrofit? 与 Java 领域 的 ORM( 用 于 实现 面向 对 象 编程 语言 里 不 同类 型 系统 的 数据 之 
间 转 换 的 一 种 编程 技术 ) 概 念 类 似 ,ORM 把 结构 化 数据 转换 为 Java 对 象 , 而 Retrofit 把 
REST API 返 回 的 数据 转化 为 Java 对 象 以 方便 操作 。Retrofit 支持 URL 参数 替换 和 查询 
参数 ,支持 Multipart 请 求 和 文件 上 传 ,同时 还 封装 了 网 络 代码 的 调用 。 

Retrofit 使 用 的 基本 步骤 如 下 : 

(D 定义 接口 ,参数 声明 ,Url 通过 Annotation 注解 。 

moviesService() 方 法 相关 的 MoviesService 核心 代码 如 下 : 


01 public interface MoviesService { 
02 


04 @GET("/movie/popular" ) 
05 MovieResultsPage popular((@Query("page") Integer varl, @Query(" language") 
06 String var2) ; 


08 @GET("/movie/{ id} /images") 
09 Images images(@Path("id") int varl, @Query("language") String var2) ; 
10 } 


定义 上 面 的 是 一 个 REST API 接口 ,该 接口 定义 了 一 个 popular() 方 法 ,该 方法 会 通过 
HTTP GET 请 求 去 访问 服务 器 的 /movie/popular 路 径 并 把 返回 的 结果 封装 为 
MovieResultsPage Java 对 象 后 返回 。 

Retrofit 的 Annotation 4 4 iff 2k 7; 1 4H X ff] @ GET, @ POST, (à HEAD, (à PUT, 
@DELETA,@PATCH 112 fH XH (9 Path, (2 Field, (à Multipart 等 。 

@ 通过 RestAdapter 生成 一 个 接口 的 实现 类 (动态 代理 ), 而 这 个 实现 类 是 通过 
RestAdapter. create() 方 法 返回 的 。 例 如 : 


01 public MoviesService moviesService() { 
02 return (MoviesService)this.getRestAdapter().create(MoviesService. class); 
03 ] 


© 调用 接口 请 求 数据 例如 前 面 描述 的 FetchTmdbPopularRunnable 中 的 
doBackgroundCall() 方 法 。 


9.3.2 数据 解析 与 显示 


1. 解析 数据 
当 TraktNetworkRunner 执行 完 后 会 发 出 sHandler. post (new ResultCallback (result, 


retrofitError) ) 请 求 , 里 面包 含 了 请 求 的 反馈 结果 ,用 于 修改 UI 的 数据 。 其 中 ResultCallback() 


(D Retrofit 官网 : http://square. github. io/retrofit/ 。 
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方法 代码 如 下 : 
01 private class ResultCallback implements Runnable { 
02 private final R mResult; 
03 private final RetrofitError mRetrofitError; 
04 
05 private ResultCallback(R result, RetrofitError retrofitError) { 
06 mResult = result; 
07 mRetrofitError = retrofitError; 
08 } 
09 


10 @Override 
n public void run() { 


12 if (mResult != null) { 

13 mBackgroundRunnable. onSuccess(mResult) ; 

14 } else if (mRetrofitError != null) { 

15 mBackgroundRunnable. onError(mRetrofitError); 
16 } 

17 mBackgroundRunnable. onFinished(); 

18 } 

TO. 


此 时 , $47 FetchTmdbPopularRunnable 的 祖父 类 BaseTmdbPaginatedRunnable 中 的 
onSuccess() 方 法 ,代码 如 下 : 


01 @Override 
02 public final void onSuccess(TR result) { 
03 if (result ! null) { 


04 R paginatedResult = getResultFromState() ; 

05 

06 if (paginatedResult == null) { 

07 paginatedResult = createPaginatedResult(); 
08 paginatedResult. items = new ArrayList <>(); 
09 } 

10 

ET updatePaginatedResult(paginatedResult, result); 
12 updateState(paginatedResult); 

13 } 

14 } 


11—12 行 分 别 执行 下 面 的 两 个 回调 方法 来 保存 获取 的 数据 并 显示 在 用 户 界 面 中 。 


01 @Override 

02 protected MoviesState. MoviePaginatedResult getResultFromState() { 

03 return mMoviesState. getPopular(); 

04 ] 

05 

06 @Override 

07 protected void updateState(MoviesState.MoviePaginatedResult result) { 
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08 mMoviesState. setPopular(result); 
09 } 


同时 ,在 FetchTmdbPopularRunnable fij 4 3$ BaseTmdbPaginatedMovieRunnable 中 
执行 回调 方法 updatePaginatedResultO ,代码 如 下 : 


01 @Override 
02 protected void updatePaginatedResult( 


03 MoviesState.MoviePaginatedResult result, 

04 MovieResultsPage tmdbResult) { 

05 result. items.addAll(getTmdbMovieEntityMapper() 
06 . napAll(tmdbResult. results) ) ; 

07 

08 result.page - tmdbResult. page; 

09 if (tmdbResult. total pages != null) { 

10 result. totalPages - tmdbResult.total pages; 
11 } 

32 


05 行 的 getTmdbMovieEntityMapper () Jy %38 E] TmdbMovieEntityMapper 对 象 ,该 
对 象 是 BaseEntityMapper 的 子 类 ,其 mapAll() 方 法 的 代码 如 下 : 


01 public List <R> mapAll(List <T> entities) { 


02 final ArrayList <R> movies = new ArrayList <>(entities. size()); 
03 for (T entity : entities) { 

04 movies. add(map(entity) ) ; 

05 } 

06 return movies; 

07: } 


04 行 的 map() 方 法 通过 多 态 的 原理 在 TmdbMovieEntityMapper 中 实现 ,代码 如 下 : 


01 @Override 
02 public PhilmMovie map(Movie entity) { 
03 PhilmMovie movie = getEntity(String. value0f (entity. id) ); 





04 

05 if (movie == null && entity. imdb id != null) { 
06 movie = getEntity(entity.imdb id); 

07 } 

08 

09 if (movie == null) { 

10 //No movie, so create one 

ir movie = new PhilmMovie(); 

12 } 

13 //We already have a movie, so just update it wrapped value 
14 movie. setFromMovie(entity) ; 

15 putEntity(movie) ; 
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16 

17 return movie; 
18 } 

2. 显示 数据 


在 MVP 中 , Model 的 数据 被 更 新 后 ,需要 通过 Presenter(MovieController) 来 更 新 
View(Model 5j View 不 能 直接 通信 )。Philm 通知 Presenter 是 通过 时 间 总 线 来 实现 的 (使 
用 的 是 Square 的 otto 消息 库 ) 。 

当 返 回 数据 解析 完毕 并 把 结果 保存 在 mMoviesState 中 后 ,调用 其 setPopular() 方 法 发 
布 消息 ,代码 如 下 : 


01 
02 
03 
04 
05 


@Override 

public void setPopular(MoviePaginatedResult items) { 
mPopular = items; 
mEventBus. post (new PopularChangedEvent() ) ; 

l 


其 中 ,发 布 事件 的 语句 mEventBus. post(new PopularChangedEvent O) fii JH ff] & otto 
库 的 消息 队列 。 在 MovieController 中 ,38 it (9 Subscribe 被 监听 ,代码 如 下 : 


01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
i 
12 
13 
14 
15 
16 
17 
18 
19 
20 


(Subscribe 

public void onPopularChanged(MoviesState. PopularChangedEvent event) ( 
populateUiFromQueryType(MovieQueryType. POPULAR) ; 

} 


private final void populateUiFromQueryType(MovieQueryType queryType) { 
MovieUi ui = findUiFromQueryType(queryType) ; 
if (ui != null) { 
populateUi(ui) ; 
D 
} 


private MovieUi findUiFromQueryType(MovieQueryType queryType) { 
for (MovieUi ui : getUis()) { 
if (ui.getMovieQueryType() == queryType) { 
return ui; 
} 
} 
return null; 


i 


执行 变更 视图 的 类 型 是 MovieQueryType. POPULAR (在 PopularMoviesFragment 的 
onResume() 中 被 注册 到 MovieController 中 ) 。 

PopularMoviesFragment 实现 了 MovieController. MovieListUi 接口 ,因此 ,populateUi() 执 
行 的 本 质 是 MovieController 中 的 populateMovieListUi() 方 法 ,核心 代码 如 下 : 
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01 private void populateMovieListUi(MovieListUi ui) { 
02 final MovieQueryType queryType = ui.getMovieQueryType(); 


03 cs 

04 if (items == null) { 

05 ui.setlItems(null); 

06 } else if (PhilmCollections. isEmpty(sections)) { 

07 ui.setlItems(createListlItemList( items)); 

08 

09 if (isLoggedIn()) ( 

10 ui.allowedBatchOperations(MovieOperation. MARK SEEN, 
TS MovieOperation.ADD TO COLLECTION, 

12 MovieOperation.ADD TO WATCHLIST); 

13 } else { 

14 ui.disableBatchOperations(); 

15 } 

16 } else { 

17 ui, setItems(createSectionedListItemList(items, sections, 
18 sectionProcessingOrder) ) ; 

19 } 

20 } 


HP 17~18 47 fh setItemsQ FARBU TF : 


01 @Override 

02 public void setItems(List <ListItem<PhilmMovie >> items) { 
03 mMovieGridAdapter. setItems(items) ; 

04 moveListViewToSavedPositions(); 

05 ] 


而 mMovieGridAdapter 的 setItems() 方 法 代码 如 下 : 


01 public void setItems(List<ListItem < PhilmMovie >> items) { 
02 if (! Objects. equal(items, mItems)) { 


03 mItems = items; 

04 notif yDataSetChanged( ) ; 
05 } 

06 } 


可 以 看 到 ,到 这 里 在 UI 中 就 获得 了 数据 ,然后 可 以 根据 URL 下 载 电影 海报 等 信息 。 


9.4 Ul 设计 


Philm 的 UI 定制 了 MovieDetailCardLayout, MovieDetailInfoLayout, SlidingTab 
Layout 和 ViewRecycler 等 大 量 的 View 及 其 管理 工具 ,并 结合 Material Design 设计 出 体验 
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9.4.1 Material Design 


虽然 Philm 没有 明确 提出 基于 Google 最 新 的 Material Design 风格 ,但 是 通过 其 样式 
设计 和 布局 设计 的 特点 可 以 看 出 ,Philm 采用 了 大 量 的 Material Design TR. 

1. 设计 原则 

Material Design 设计 的 基本 原则 如 下 。 

(1) 实体 感 就 是 隐喻 

通过 构建 系统 化 的 动 效 和 空间 合理 化 利用 ,并 将 两 个 理念 合 二 为 一 ,构成 了 实体 隐喻 。 
实体 的 表面 和 边缘 提供 基于 真实 效果 的 视觉 体验 ,熟悉 的 触感 让 用 户 可 以 快速 地 理解 和 认 
知 。 实 体 的 多 样 性 可 以 让 应 用 呈现 出 更 多 反映 真实 世界 的 设计 效果 ,但 同时 又 绝 不 会 脱离 
客观 的 物理 规律 。 

在 电影 详情 界面 ,界面 的 首页 显示 了 图 9-17 中 的 大 背景 海报 和 大 字体 电影 名 称 , 随 着 
手指 的 向 上 滑动 ,电影 海报 逐渐 缩减 成 如 图 9-18 所 示 的 剪裁 的 海报 背景 ,同时 ,电影 的 名 称 
也 逐渐 缩小 到 界面 标题 的 位 置 。 
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饰 ) 和 布 莱 恩 ( 保罗 .沃克 Paul Walker th) 重 获 
自由 一 年 多 后 ,他 们 摆脱 障 无 天 日 的 亡命 生 





Vengeance Hits Home 活 ， 却 发 现 这 个 家 脱离 现实 。 多米 尼 克 忙 着 和 莱 
$9 ( 米 软 尔 : 罗 德里 格 兹 Michelle Rodriguez... 
O ."-H  h 
图 9-17 电影 详情 界面 首页 图 9-18 向 上 滑动 后 的 首页 


(2) 鲜明 形象 .深思熟虑 

新 的 视觉 语言 ,在 基本 元 素 的 处 理 上 ,借鉴 了 传统 的 印刷 设计 一 一 排版 、 网 格 、 空 间 、 比 
例 、 配 色 、 图 像 使 用 一 一 这 些 基 础 的 平面 设计 规范 。 在 这 些 设计 基础 上 下 功夫 ,不 但 可 以 愉 
悦 用 户 ,而 且 能 够 构建 出 视觉 层级 、 视 觉 意义 以 及 视觉 聚焦 。 精 心 选 择 色 彩 、 图 像 ,选择 合乎 
比例 的 字体 、 留 白 ,力求 构建 出 鲜明 、 形 象 的 用 户 界 面 , 让 用 户 沉浸 其 中 。 

在 Philm 中 , 主 界面 (MainActivity) 包含 的 Fragment 及 ViewPage 采用 了 唯一 主 色 调 
风格 ,这 样 能 够 很 好 地 表达 界面 层次 、 重 要 信息 ,并 且 能 展现 良好 的 视觉 效果 。 现 在 越 来 越 
多 唯一 主 色 调 风格 的 设计 ,多 采用 简单 的 色 阶 、 配 套 灰 阶 来 展现 信息 层次 ,但 是 绝 不 采用 更 
多 的 颜色 。 

(3) 有 意义 的 动画 效果 

动画 效果 (简称 动 效 ) 可 以 有 效 地 暗示 、 指 引用 户 。 动 效 的 设计 要 根据 用 户 行为 而 定 , 能 
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够 改变 整体 设计 的 触感 。 动 效应 当 在 独立 的 场景 中 呈现 。 通 过 动 效 ,让 物体 的 变化 以 更 连 
续 、 更 平滑 的 方式 呈现 给 用 户 , 让 用 户 能 够 充分 知晓 所 发 生 的 变化 。 

2. 布局 原则 

Material Design 使 用 的 基本 工具 来 源 于 印刷 设计 ,例如 通用 于 所 有 界面 的 基准 线 和 栅 
格 。 布 局 排版 能 够 按 比例 横 跨 不 同 尺 寸 的 屏幕 ,促进 UI 开发 和 从 根本 上 帮助 设计 师 做 可 
扩展 的 应 用 。 

CD 电影 详情 界面 

电影 详情 界面 如 图 9-3 所 示 ,该 界面 基本 遵循 了 Material Design 中 关于 水 平 边 距 设计 
的 准则 (图 9-19) 。 

其 中 ,@、@.、@、@ 处 的 尺寸 分 别 是 24dp、56dp、8dp 和 72dp。 

提示 : dp Æ Android 中 非 文 字 的 尺寸 单位 ,是 density-independent pixels (密度 独立 像 
素 ) 的 缩写 。 

(2) 搜索 界面 

搜索 界面 如 图 9-11 所 示 ,该 界面 基本 遵循 了 图 9-20 所 示 的 Material Design 设计 原则 。 

其 中 ,@、@、@.、@.@ 处 的 尺寸 分 别 是 24dp、56dp、72dp、48dp 和 8dp。 





Image dimesion 
3:2 














图 9-19 Material Design 1 图 9-20 Material Design 2 


3. 字体 原则 
自从 Ice Cream Sandwich 发 布 以 来 ,Roboto 都 是 Android 系统 的 默认 字体 集 , 如 图 9-21 
所 示 。 
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”Light 112sp 


ii Regular 56sp 


Display 2 Regular 45sp 
Display 1 Regular 34sp 


Hondina Regular 24sp 

Title Medium 20sp 

Subhead Regular 16sp (Device), Regular 15sp (Desktop) 
Body 2 Medium 14sp (Device), Medium 13sp (Desktop) 
Body 1 Regular 14sp (Device), Regular 13sp (Desktop) 
Caption Regular 12sp 

Menu Medium 14sp (Device), Medium 13sp (Desktop) 
Button MEDIUM (ALL CAPS) 14sp 


9-21 Roboto 字体 样式 


同时 使 用 过 多 的 字体 尺寸 和 样式 会 很 轻易 地 毁 掉 布局 。 字 体 排版 的 缩放 是 包含 了 有 限 
个 字体 尺寸 的 集合 ,并 且 它 们 能 够 良好 地 适应 布局 结构 。 最 基本 的 样式 集合 就 是 基于 12、 
14、16、20 和 34 号 的 字体 排版 缩放 。 这 些 尺 寸 和 样式 在 经 典 应 用 场合 中 让 内 容 密 度 和 阅读 
舒适 度 取 得 平衡 。 字 体 尺寸 是 通过 SP(scaleable pixels ,可 缩放 像素 数 ) 指 定 的 ,让 大 尺寸 字 
体 获得 更 好 的 可 接受 度 。 

在 电影 详情 界面 中 ,电影 名 称 采用 了 Displayl 的 样式 ,评分 采用 Headlne 样式 ,电影 简 
介 采 用 Caption 样式 。 


9.4.2 UI 布局 


1. 主 界面 设计 
主 界面 MainActivity 的 布局 是 一 个 DrawerLayout, 由 MenuFragment (SideMenuFragment ) 
和 显示 内 容 Fragment 组 成 。 布 局 文件 如 下 : 


01 <?xml version= "1.0" encoding = "utf - 8"?> 

02 <android. support.v4.widget.DrawerLayout 

03 xmlns:android= "http://schemas.android. con/apk/res/android" 
04 android:id- "(à + id/drawer layout" 

05 android: layout_width = "match parent" 

06 android: layout_height = "match parent" 

07 android:fitsSystemWindows = "true" > 
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08 

09 < include layout = "(Qlayout/activity no drawer" /> 

10 

11 « fragnent 

12 android: id= "@ + id/fragment side menu" 

13 android:name = "app. philm. in. fragments. SideMenuFragment" 
14 android: layout_width = "@dimen/drawer_side_menu_width"” 
15 android: layout_height = "match parent" 

16 android: layout_gravity = "left" /> 

T7: 


18 </android. support. v4. widget. DrawerLayout > 


在 Fragment 中 以 Tab 页 组 织 UI Ai. HEPAT Viewpager 来 管理 多 个 Fragment。 
使 用 Tab 将 大 量 关联 的 数据 或 者 选项 划分 成 更 易 理 解 的 分 组 ,可 以 在 不 需要 切换 出 当前 上 
下 文 的 情况 下 ,有 效 地 进行 内 容 的 导航 和 组 织 。 

该 界面 的 设计 原则 如 下 o 
Tab 的 宽度 为 : 12dp 十 文本 宽度 十 12dp。 
激活 的 Tab 指示 器 高 度 为 2dp 。 

。 文本 属性 为 14sp、Roboto 和 Medium, 

。 文 本 在 Tab 中 居中 。 

。 激活 的 文字 颜色 为 # ftf 或 颜色 选择 中 的 次 要 颜色 。 

。 AA NSCS BIA 60% H + fff. 

2. 电影 详情 界面 设计 

电影 详情 界面 以 卡片 式 设计 为 主 , 其 中 显示 电影 详情 的 布局 文件 如 下 : 


01 <?xml version = "1.0" encoding = "utf - 8"?> 
02 <FrameLayout xmlns:android = "http://schemas. android. com/apk/res/android" 


03 xmlns:app = "http://schemas. android. com/apk/res — auto" 

04 android:layout height = "match parent" 

05 android:layout width = "match parent" 

06 

07 < include layout = "(glayout/include fragment detail list"/> 

08 

09 X app. philm. in. view. CollapsingTitleLayout 

10 android: id = "(à + id/backdrop toolbar" 

Er android:layout width = "match parent" 

12 android:layout height = "wrap content" 

13 android:elevation- "(Qdimen/movie detail pinned elevation" 
14 android: textAppearance = "@style/TextAppearance. AppCompat. 
15 Widget. ActionBar. Title. Inverse” 

16 app: expandedTextSize = "56dp" 

17 app: expandedMargin = "16dp"> 

18 

19 <app. philm. in. view. BackdropImageView 

20 android: id= "@ + id/imageview fanart" 
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21 android: layout_width = "match parent" 

22 android: layout_height = "@dimen/movie detail fanart height" 
23 android: scaleType = "centerCrop" 

24 android: background = "?attr/colorPrimary" /> 

25 

26 <android. support. v7. widget. Toolbar 

27 android: id= "@ + id/toolbar" 

28 android: layout_height = "?attr/actionBarSize" 

29 android: layout_width = "match parent" 

30 style = "@style/Widget. Philm. Toolbar. Transparent" /> 
ak 

32 </app. philm. in. view. CollapsingTitleLayout > 

33 


34 </FrameLayout > 


卡片 是 一 种 采用 较 多 的 设计 语言 形式 ,卡片 式 设计 在 栅 格 的 基础 上 更 进 了 一 步 ,将 整个 
页 面 的 内 容 切割 为 许多 个 区 域 , 不 仅 能 给 人 很 好 的 视觉 一 致 性 ,而 且 更 易于 实现 设计 上 的 迭 
代 。Google 的 移动 端 产 品 设计 已 经 全 面 卡片 化 了 ,甚至 Web 端 也 沿用 了 这 种 统一 的 设计 
语言 。 

对 于 移动 设备 碎片 化 的 屏幕 来 说 ,卡片 是 完美 的 设计 形式 。 在 手机 上 ,卡片 通常 以 垂直 
方式 展现 。 电 影 详情 界面 使 用 卡片 式 列表 框架 展示 信息 ,卡片 流 突 出 信息 本 身 , 用 大 图 和 标 
题 文 字 吸 引用 户 ,强化 了 无 尽 浏览 的 体验 。Philm 中 ,不 同 的 卡片 都 遵循 在 一 个 统一 宽度 和 
样式 的 卡片 内 ,进行 发 挥 和 设计 , 既 保证 了 卡片 和 卡片 之 间 的 独立 性 ,又 保证 了 服务 和 服务 
的 统一 化 设计 。 

3. 登录 界面 设计 

登录 界面 以 扁平 化 的 设计 风格 展示 界面 信息 ,布局 核心 代码 如 下 : 


01 <?xml version = "1.0" encoding = "utf - 8"?> 

02 <LinearLayout xmlns:android = "http: //schemas. android. com/apk/res/android" 
03 xmlns: philm = "http: //schemas. android. con/apk/res — auto" 

04 android: layout_width = "match parent" 

05 android: layout_height = "match parent" 


06 android: orientation = "vertical" > 

07 

08 <ScrollView 

09 android: layout_width = "match parent" 

10 android: layout_height = "0px" 

11 android:layout weight- "1" » 

12 

T3 < LinearLayout 

14 sees 

15 android:orientation = "vertical" 

16 android: padding = "@dimen/spacing_major” > 
17 

18 < app. philm. in. view. FontTextView ... /> 
19 
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20 <app.philm. in. view. FloatLabelLayout ... > 
21 

22 <EditText ... /> 

23 </app. philm. in. view. FloatLabelLayout > 

24 

25 <app. philm. in. view. FloatLabelLayout ... > 
26 

27 <EditText ... /> 

28 </app. philm. in. view. FloatLabelLayout > 

29 

30 <app. philm. in. view. FloatLabelLayout ... > 
31 

32 < hutoCompleteTextView ... /> 

33 «/app. philm. in. view. FloatLabelLayout > 
34 

35 < RadioGroup 

36 rus 

37 </RadioGroup > 

38 </LinearLayout > 

39 </ScrollView> 

40 

41 < View 

42 android: layout_width = "match parent" 

43 android: layout_height = "1dp" 

44 android: background = "?android:attr/dividerVertical" /> 
45 

46 <LinearLayout 

47 a 

48 

49 < Button ... /> 

50 </LinearLayout > 

51 


52 </LinearLayout > 


扁平 化 设计 是 一 种 设计 风格 术语 , 它 抛弃 任何 能 使 得 作品 凸显 3D 效果 的 特性 。 通 俗 
地 说 ,设计 中 不 使 用 透视 ,纹理 、 阴 影 等 效果 。 

扁平 化 设计 通常 采用 许多 简单 的 用 户 界面 元 素 ,诸如 按钮 或 者 图 标 之 类 。 设 计 师 通常 
坚持 使 用 简单 的 外 形 ( 和 矩形 或 者 圆 形 ) ,并 且 尽量 突出 外 形 ,这 些 元 素 一 律 为 直角 ( 极 个 别 的 
为 圆 角 ) 。 这 些 用 户 界面 元 素 方便 用 户 点 击 , 能 极 大 地 减少 用 户 学 习 新 交互 方式 的 成 本 , 因 
为 用 户 凭 经 验 就 能 大 概 知道 每 个 按钮 的 作用 。 

扁平 化 设计 在 整体 上 趋 近 极 简 主 义 设计 理念 。 设 计 师 要 尽量 简化 自己 的 设计 方案 , 避 
免 不 必要 的 元 素 出 现在 设计 中 。 


9.4.3 Fragment 设计 


Fragment 是 Android API 11 引入 的 概念 ,Fragment 为 开发 者 和 设计 师 提 供 了 一 种 全 
新 的 方法 ,让 他 们 设计 的 应 用 变 得 有 弹性 、 可 堆 释 ,从 而 适应 不 同 设备 的 屏幕 规格 。 屏 幕 组 


279 





移动 互联 网 应 用 开发 (基于 Android #8) 


件 可 以 自由 拉 伸 、 堆 释 \ 缩 放 和 隐藏 ,以 支持 更 动态 、 更 灵活 的 界面 设计 。 


明 。 


E. 


1. 类 层次 结构 
下 面 以 图 9-1 显示 的 当前 流行 电影 的 Fragment PopularMoviesFragment 为 例 说 
通过 代码 分 析 可 以 看 出 ,PopularMoviesFragment 存在 图 9-22 所 示 的 类 继承 关系 。 


android.support.v4.app.Fragment 





app.philm.in.fragments.base.BasePhilmFragment 
app.philm.in.fragments. base. ListFragment<E> 
S app.philm.in.fragments.base.BaseMovieControllerListFragment<E, PhilmMovie> 
[app philm.in fragments base. BasePhilmMovieListFragment<GridView> 
m app.philm.in.fragments.base. MovieGridFragment 


| app.philm.in.fragments.base.PopularMoviesFragment 


图 9-22 PopularMoviesFragment 的 继承 关系 


(1) PopularMoviesFragment 
实现 MovieController. SubUi 接口 ,并 实现 如 下 回调 方法 : 


01 @Override 

02 public MovieController. MovieQueryType getMovieQueryType() { 
03 return MovieController. MovieQueryType. POPULAR; 

04 ] 


该 回调 方法 的 主要 作用 是 告诉 控制 器 当前 界面 需要 显示 的 数据 是 流行 电影 信息 。 

(2) MovieGridFragment 

MovieGridFragment 的 核心 任务 包括 两 点 。 

(D 创建 并 初始 化 MovieGridAdapter 适配器 ,然后 将 数据 显示 在 内 嵌 的 Grid View 控件 
代码 如 下 : 


01 @Override 

02 public void onCreate(Bundle savedInstanceState) { 

03 super. onCreate(savedInstanceState); 

04 

05 mMovieGridAdapter - new MovieGridAdapter(getActivity()); 
06 setListAdapter(mMovieGridAdapter); 

07 F 


© 设置 GridView 每 个 Item 的 单 击 事件 , 即 在 界面 上 单 击 每 个 电影 海报 ,可 以 显示 电 


影 详情 的 事件 处 理 情况 。 代 码 如 下 : 


280 


01 @Override 

02 public void onListItemClick(GridView 1, View v, int position, long id) { 
03 if (hasCallbacks()) ( 

04 ListItem <PhilmMovie> item = (ListItem<PhilmMovie>) 1 

05 . get ItemAtPosition(position) ; 
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06 if (item.getListType() == ListItem. TYPE_ITEM) { 

07 getCallbacks().showMovieDetail(item.getListlItem(), 
08 ActivityTransitions. scaleUpAnimation(v)); 
09 } 

10 } 

in ft 


(3) BasePhilmMovieListFragment<GridView> 

BasePhilmMovieListFragment 实现 Movie- 
Controller. MovieListUi 和 AbsListView. On- 
ScrollListener 接口 。 在 功能 上 ,主要 完成 如 下 
任务 H 

(D 通过 onCreateOptionsMenuO ,onPrepar- 
eOptionsMenu() fll onOptionsItemSelected O = 
个 回调 方法 创建 选项 菜单 。 


somai 


@ 设置 长 按 GridView 中 的 Item, Bl Ic f E so 
影 海报 时 的 动作 ,显示 效果 如 图 9-23 所 示 。 





长 按 响 应 动作 栏 显 示 后 ,可 以 单 击 多 个 电影 
海报 ,每 个 被 选中 的 海报 以 矩形 填充 方块 显示 ， 图 9.23 长 按 海 报 动作 栏 的 设计 
以 支持 批量 处 理 。 核 心 代码 如 下 : 


01 private class MovieMultiChoiceListener implements 

02 AbsListView.MultiChoiceModeListener { 

03 

04 @Override 

05 public void onItemCheckedStateChanged(ActionMode mode, int position, 


06 long id, boolean checked) { 
07 //NO - OP 

08 } 

09 


10 @Override 
11 public boolean onCreateActionMode(ActionMode mode, Menu menu) { 


12 mode. getMenuInflater(). inflate(R. menu. cab movies, menu); 

13 

14 for (int i = 0, z = mBatchOperations.length; i< z; i++) ( 

15 switch (mBatchOperations[i]) { 

16 case ADD_TO COLLECTION: 

17 menu. findItem(R. id. menu add collection). setVisible(true) ; 
18 break; 

19 case ADD_TO_WATCHLIST: 

20 menu. findItem(R. id. menu add watchlist).setVisible(true); 
ZR break; 

22 case MARK SEEN: 

23 menu. findItem(R. id. menu mark seen).setVisible(true); 

24 break; 
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25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 


} 
} 
return true; 
h 
@Override 


public boolean onPrepareActionMode(ActionMode mode, Menu menu) { 
return false; 


@Override 
public boolean onActionItemClicked(ActionMode mode, MenuItem item) { 
if (hasCallbacks()) { 
final E listView = getListView(); 
final SparseBooleanArray checkedltems - 
listView.getCheckedItemPositions(); 
final ArrayList <PhilmMovie> movies = new 
ArrayList <>(checkedItems. size()); 
for (int i = 0, z = checkedItems. size(); i<z; i++) ( 
if (checkedItems. valueAt(i)) { 
final int index = checkedItems. keyAt( i); 
ListItem <PhilmMovie> listItem = (ListItem<PhilmMovie >) 
listView. get ItemAtPosition( index) ; 
if (listItem. getListType() == ListItem.TYPE_ITEM) { 
movies. add(listItem. getListItem() ) ; 


switch (item. getItemId()) { 

case R. id. menu_mark_seen: 
getCallbacks().setMoviesSeen(movies, true); 
return true; 

case R. id. menu add collection: 
getCallbacks().setMoviesInCollection(movies, true); 
return true; 

case R. id. menu add watchlist: 
getCallbacks().setMoviesInWatchlist(movies, true); 
return true; 


} 


return false; 


@Override 
public void onDestroyActionMode(ActionMode mode) { 
//NO — OP 


BOs Philm fB 


` 


a 
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(4) BaseMovieControllerListFragment<E, PhilmMovie> 
BaseMovieControllerListFragment 实现 MovieController. BaseMovieListUi< T > fil 
AbsListView. OnScrollListener 接口 。 在 功能 上 ,主要 完成 如 下 任务 。 
(D 在 onResume() 中 调用 getController(). attachUi(this) 进 行 UI 的 泻 染 , 这 个 UI 对 
应 的 Controller 为 MovieController ,在 MovieController 中 先是 执行 BaseUiController 中 的 
attachUi, 然 后 紧 接 着 执行 onUiAttached, 这 个 方法 在 MovieController 中 实现 。 
@ 保存 当前 电影 海报 的 浏览 位 置 , 代 码 如 下 : 


01 
02 
03 
04 
05 
06 
07 
08 
09 
10 


private void saveListViewPosition() ( 
E listView = getListView(); 


mFirstVisiblePosition = listView.getFirstVisiblePosition(); 
if (mFirstVisiblePosition !- AdapterView. INVALID POSITION && 


listView.getChildCount() » 0) ( 
mFirstVisiblePositionTop = listView.getChildAt(0).getTop(); 


@ 实现 界面 的 上 拉 刷 新 , 即 加 载 更 多 的 电影 信息 ,核心 代码 如 下 : 


01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 


@Override 


public final void onScrollStateChanged(AbsListView view, int scrollState) { 


if (scrollState == AbsListView. OnScrollListener. SCROLL STATE IDLE && 


mLoadMoreIsAtBottom) ( 

if (onScrolledToBottom()) { 
mLoadMoreRequestedItemCount = view.getCount(); 
mLoadMoreIsAtBottom = false; 


} 


@Override 
public final void onScroll(AbsListView view, int firstVisibleItem, 
int visibleItemCount, int totalltemCount) { 
mLoadMoreIsAtBottom = totalltemCount > mLoadMoreRequestedItemCount 
&& firstVisibleItem + visibleItemCount == totalltemCount; 
} 


protected boolean onScrolledToBottom() { 

if (Constants. DEBUG) { 
Log.d(LOG TAG, "onScrolledToBotton"); 

b 

if (hasCallbacks()) { 
getCallbacks().onScrolledToBotton(); 
return true; 

} 


return false; 
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(5) ListFragment- E> 

ListFragment 主要 是 初始 化 UI 布 局 以 及 涉及 的 相关 动画 。 

(6) BasePhilmFragment 

BasePhilmFragment 主要 是 设置 对 动作 栏 的 支持 。 

2. 数据 适 配 

PopularMoviesFragment 以 GridView 填充 用 户 界 面 , 因 此 , 当 从 开放 接口 获取 相关 数 
据 后 ,通过 继承 自 BaseAdapter 的 MovieGridAdapter 适配器 将 数据 适 配 在 Fragment 中 。 
MovieGridAdapter 的 核心 代码 如 下 : 


01 public class MovieGridAdapter extends BaseAdapter { 


02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 
16 
iri 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
BL 
32 
33 
34 
35 
36 
37 
38 
39 


public MovieGridAdapter(Activity activity) { 
mActivity = activity; 
mLayoutInflater = mActivity.getLayoutInflater(); 


public void setItems(List < ListItem « PhilmMovie >> items) { 
if (!Objects.equal(items, mItems)) { 
mItems = items; 
notif yDataSetChanged( ) ; 


@Override 
public int getCount() { 
return mItems != null? mItems. size() : 0; 


@Override 
public ListItem <PhilmMovie > getItem(int position) { 
return mItems. get (position) ; 


@Override 
public long getltemId(int position) { 
return position; 


@Override 
public View getView(int position, View convertView, ViewGroup viewGroup) { 
View view = convertView; 
if (view == null) { 
view = mLayoutInflater. inflate(R. layout. item_grid_movie, 
viewGroup, false); 
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40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 


final PhilmMovie movie = getItem(position).getListItem(); 


final TextView title - (TextView) view 

. findViewById(R. id. textview title); 
title. setText(movie.getTitle()); 
title. setVisibility(View. VISIBLE) ; 


final PhilmImageView imageView = (PhilmImageView) view 
. findViewById(R. id. imageview poster); 
imageView. setAutoFade(false); 
imageView. loadPoster(movie, new PhilmImageView.Listener() { 
@Override 


public void onSuccess(PhilmImageView imageView, Bitmap bitmap) { 


title.setVisibility(View.GONE); 


@Override 
public void onError(PhilmImageView imageView) { 
title. setVisibility(View. VISIBLE); 
n; 


return view; 


9.4.4 Activity 实现 


Philm Jj A 3E & à 7 个 Activity; MainActivity, MovieActivity, PersonActivity, 
AccountActivity , AboutActivity ,SettingsActivity 和 MovielmagesActivity 。 

下 面 主要 分 析 MainActivity 的 设计 。 

在 AndroidManifest. xml 中 ,关于 MainActivity 的 声明 信息 如 下 : 


01 <activity 


02 
03 
04 
05 
06 
07 
08 
09 
10 


android:name = ".MainActivity" 
android: label = "@string/app_name" 
android: launchMode = "singleTask"> 


< intent - filter > 


X action android: name = "android. intent. action. MAIN" /> 
< category android:name = "android. intent. category. LAUNCHER" /> 


«/intent- filter > 


11 </activity> 


04 fT android: launchMode 属性 值 为 singleTask, iE J singleTask 启动 模式 的 
Activity 不 是 在 新 的 任务 中 启动 时 , 它 会 在 已 有 的 任务 中 查看 是 否 已 经 存在 相应 的 Activity 
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实例 ,如 果 存 在 ,就 会 把 位 于 这 个 Activity 实例 上 面 的 Activity 全 部 结束 , 即 最 终 这 个 
Activity 实例 会 位 于 任务 的 堆栈 顶端 。 因 此 ,保证 了 Activity 只 实例 化 一 次 ,由 此 所 开启 的 
Activity 和 本 Activity 位 于 同一 任务 中 。 但 是 ,如 果 Activity 已 经 在 其 他 任务 中 存在 实例 ， 
则 系统 会 通过 调用 其 实例 的 onNewIntent() 方 法 把 Intent 传 给 已 有 实例 ,而 不 是 再 创建 一 
个 新 实例 。 

在 其 他 Activity 的 声明 中 ,多 有 如 下 信息 : 


01 <activity 


02 android:name = ".AboutActivity" 

03 E 

04 android:parentActivityName =". MainActivity"> 

05 

06 <meta - data 

07 android:name = "android. support.PARENT ACTIVITY" 
08 android:value - ".MainActivity" /> 

09 


10 </activity> 


KB , android: parentActivityName 的 作用 是 给 当前 Activity 的 界面 左上 角 添 加 一 个 返 
回 按钮 ,android ; name— "android. support. PARENT_ACTIVITY" 属 性 用 于 指定 : 当 单 击 
界面 左上 角 的 返回 按钮 时 ,返回 到 android: value 


android.support.v7.app.ActionBarActivity 


指定 的 Activity 界面 。 L 
MainActivity 的 继承 关系 如 图 9-24 所 示 。 app.philm.in.BasePhilmActivity 
(1) MainActivity app.philm.in.MainActivity 
MainActivity 主要 完成 如 下 工作 : 图 9-24 MainActivity 的 继承 关系 
(D 重 写 onCreateOptionsMenu C) 回调 方法 来 

创建 选项 菜单 。 


© 在 onResume() 生 命 周期 方法 中 调用 getMainController(). attachUi(this) 方 法 实现 
视图 泻 染 ; 在 onPauseO 生命 周期 方法 中 调用 getMainController(). detachUi(this) 方 法 清 
2 CallBack, 

© #F handleIntent() 回 调 方法 来 设置 侧 边 菜单 。 

(2) BasePhilmActivity 

BasePhilmActivity 主要 完成 如 下 工作 : 

(D 在 onCreate()、onResume() 生 命 周 期 方法 中 初始 化 整个 项 目的 MainController 和 
Display ,核心 代码 如 下 : 


01 @Override 

02 protected void onCreate(Bundle savedInstanceState) { 

03 ccn 

04 setContentView(getContentViewLayoutId()); 

05 mMainController = PhilmApplication. from(this).getMainController(); 
06 mDisplay 7 new AndroidDisplay(this, mDrawerLayout); 

07 handleIntent(getIntent(), getDisplay()); 
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08 ] 

09 

10 @Override 

11 protected void onResume() ( 

12 super. onResune( ) ; 

13 mMainController. attachDisplay(mDisplay); 
14 mMainController. setHostCallbacks(this); 
15 mMainController. init(); 

16 ] 


© 重 写 onOptionsItemSelected() 回 调 方法 响应 菜单 事件 。 核 心 代码 如 下 : 


17 @Override 
18 public boolean onOptionsItemSelected(MenuItem item) { 


19 switch (item. getItemId()) ( 

20 case android. R. id. home: 

21 if (getMainController().onHomeButtonPressed()) { 
22 return true; 

25 } 

24 if (navigateUp()) { 

25 return true; 

26 } 

27 break; 

28 

29 

30 } 

31 

32 return super. onOptionsItemSelected( item); 
339r 
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